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INTRODUCTION 


Developing for Windows and the 
Web: Guide to Visual Studio 6.0, 
Professional Edition 


This book is intended to help you discover the possibilities in each Microsoft® Visual 
Studio™ tool, by describing what you can do with each tool and pointing you to product 
samples and documentation. This book also introduces the Island Hopper News sample 
application at a high level. The book includes the following sections. 


Section Description 
Chapter 1: Developing Applications Provides information on how to use the book, brief overviews of 
with Visual Studio 6.0 the Visual Studio tools, and high-level discussions of the types of 


applications you can build using Visual Studio. Includes overviews 
of important related technologies. 


Chapter 2: Choosing the Right Tools Examines each Visual Studio tool in terms of its support for fast 
for the Job development, Web applications, and data-centric applications. 


Chapter 3: Island Hopper News Sample Describes the Island Hopper News sample application. Includes 
information about the pieces of the sample and how those pieces fit 
together. 
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CHAPTER 1 


Developing Applications with 
Visual Studio 6.0 


This chapter is intended to introduce each of the tools in the Microsoft Visual Studio 
Professional Edition suite, provide a high-level overview of the types of applications you 
can build with Visual Studio tools, and describe some of the key technologies underlying 
those application types. The chapter includes pointers to more information available online 
in the Microsoft® Developer Network (MSDN) Library, Visual Studio 6.0 edition, which is 
shipped with Visual Studio. 


This chapter includes the following sections. 


Section Description 

How to Use This Book Describes the audience for the book and provides an overview of 
the book's contents. 

What's in the Professional Edition Introduces each tool in the Visual Studio 6.0 Professional Edition. 

What Can You Build with Visual Surveys the different types of applications you can build with 

Studio? Visual Studio, focusing on Web applications and data-centric 
applications. Includes overviews of key Web and data access 
technologies. 


How To Use This Book 


This book is intended for developers whose primary development tool is either Microsoft® 
Visual Basic® or Microsoft® Visual C++°®, but who are interested in learning about the 
other tools in the Visual Studio suite. This book provides a synthesis of material that is 
distributed throughout the MSDN library. Managers and those who evaluate tools might 
also find this book of interest. 
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Finding Information Fast 


This book provides overviews of the tools in the Professional Edition of the Visual Studio 
suite. You can read either general information about the tools or more specific information 
about the way the tools support fast development, Web applications, and data-centric 
applications. 


For general overviews of each tool, see What's in the Professional Edition in this 
chapter. 


If you are interested in working faster yet more productively, see Tools for Fast 
Development in Chapter 2 for a summary of what Visual Studio provides to help you. 


If you want to build an application for your company intranet or for the Internet, see 
Tools for Web Applications in Chapter 2 for a look at what the different Visual Studio 
tools offer to support Web application development. 


If you want to build a data-centric application — that is, an application whose purpose 
is querying a database and returning the results — see Tools for Data-Centric 
Applications in Chapter 2 for a summary of the support offered by each Visual Studio 
tool for data-centric applications. 


If you want more information about the Island Hopper News sample application, which 
showcases how to build a distributed application using Microsoft tools and 
technologies, see The Island Hopper News Sample in Chapter 3. 


For definitions of unfamiliar terms, see the Enterprise Glossary online in MSDN 
Library Visual Studio 6.0. 


What's In the Professional Edition 


Visual Studio, Professional Edition, consists of the following Microsoft development tools: 


Microsoft Visual Basic 6.0, Professional Edition 
Microsoft Visual C++ 6.0, Professional Edition 
Microsoft® Visual FoxPro® 6.0, Professional Edition 
Microsoft® Visual InterDev™ 6.0 

Microsoft® Visual J++™ 6.0 
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Visual Basic 


Visual Basic is the fastest and easiest way to create applications for Microsoft® Windows. 
Visual Basic provides a complete set of tools to simplify rapid application development, 
whether you are an experienced developer or new to Windows programming. You can take 
advantage of these tools to create a small utility for yourself or your work group, a large 
enterprise-wide system, or even a distributed application that spans the globe via the 
Internet. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Visual Basic Documentation Map 


e What's New in Visual Basic 6.0 


Visual C++ 


Visual C++ is the development tool used to build many of the most well-known desktop 
software applications in the world, including Microsoft® Word and Microsoft® Excel. 
Many applications continue to require the language flexibility of C++ and the performance 
tuning options of a sophisticated C/C++ compiler, which makes Visual C++ the ideal tool 
for the most demanding performance requirements. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Visual C++ Start Page 

e Visual C++ Documentation Map 

e What's New in Visual C++ 6.0 


Visual FoxPro 


Visual FoxPro is the object-oriented database management system that gives you speed, 
power, and flexibility, and provides object and event models that help you create and 
modify applications faster than ever before. With Visual FoxPro, you can also quickly 
create automation servers that can be deployed locally or remotely. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Visual FoxPro Start Page 

e Visual FoxPro Documentation Map 

e What's New in Visual FoxPro 6.0 
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Visual InterDev 


Visual InterDev is the Web development system that provides all the tools for creating 
dynamic Internet and intranet Web applications. With Visual InterDev, you can create 
data-driven Web applications, Web applications that take advantage of the latest advances 
in browser technology, and integrated Web-based solutions that can include applets or 
server-side COM components created in Visual Basic, Visual C++, Visual FoxPro, and 
Visual J++. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Visual InterDev Start Page 
e Visual InterDev Documentation Map 


e What's New in Visual InterDev 6.0 


Visual J++ 


Visual J++ is the tool that offers a high-productivity visual environment and integrated 
high-performance components to create, test, tune, and deploy Java code. Visual J++ is an 
integrated Windows-hosted development tool for Java programming. With Visual J++, you 
can create, compile, modify, run, and debug Java programs within a single environment. 
You can also package your Java applications and applets for easy distribution to the Web. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Visual J++ Start Page 
e Visual J++ Documentation Map 


e What's New in Visual J++ 6.0 


What Can You Build with Visual Studio? 


You can build just about anything you can imagine with Visual Studio, Professional 
Edition, including single-user applications, Web applications, and data-centric 
applications. The Visual Studio tools contain many features to help you build your 
applications as quickly as possible. 


Since it would be impossible to describe each of the many different kinds of applications 
you could build with Visual Studio, and since it would be easy to miss the kinds of 
applications that haven't even been thought of yet, this book looks at two popular types of 
applications and provides a survey of how each Visual Studio tool supports developing 
these applications. These applications are: 


e Web applications. 


e Data-centric applications. 
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For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e To skip to the survey, see Choosing the Right Tools for the Job in Chapter 2. 


e To get a sense of what is meant by "Web application" and for overviews on some 
related technologies, see Web Applications in this chapter. 


e To get a sense of what is meant by "data-centric application" and for overviews on 
some related technologies, see Data-Centric Applications in this chapter. 


Web Applications 


These days, "Web application" is almost as broad a term as "application." If you think of 
applications in terms such as "single-user," "multiuser," "client/server," or "distributed," 
you can add the term "Web application" to any one of those. Using a Web-based client for 
a distributed or client/server application is becoming more common. In fact, the Island 
Hopper News sample includes examples of both Web-based and Windows-based clients 
(see The Island Hopper News Sample in Chapter 3 for more information). 


You can use Visual Studio tools to build any kind of Web application, from your own 
family Web site, to an intranet for your workgroup, all the way to a company Web site on 
the Internet. Visual Studio tools make it easy for you to create powerful Web solutions by 
combining your development skills with the latest Web technologies. Two of the 
technologies that you have probably heard about are Active Server Pages (ASP) and 
Dynamic HTML (DHTML). 


Active Server Pages 


Active Server Pages (ASP) is a server-side scripting environment that you can use to create 
dynamic Web pages or build powerful Web applications. ASP pages are files that contain 
HTML tags, text, and script commands. ASP pages can call ActiveX® components to 
perform tasks, such as connecting to a database or performing a business calculation. With 
ASP, you can add interactive content to your Web pages or build entire Web applications 
that use HTML pages as the interface to your customer. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Introducing Active Server Pages 

e Using Scripting Languages 

e Writing Simple Scripts 


ASP Applications 
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Dynamic HTML 


Dynamic HTML is a set of innovative features included in Microsoft® Internet Explorer 
4.0 and later to provide authors with the power to dynamically change the rendering and 
content of a document. With Dynamic HTML, authors can create visually outstanding 
HTML documents that interact with the user without the burden of relying on server-side 
programs or complicated sets of HTML pages to achieve special effects. 


You can use Dynamic HTML to easily add effects to your documents that were previously 
difficult to achieve. For example, you can: 


e Hide text and images in your document and keep this content hidden until a given time 
elapses or the user interacts with the page. 


e Animate text and images in your document, independently moving each element from 
any starting point to any ending point, following a path that you choose or that you let 
the user choose. 


e Create a ticker that automatically refreshes its content with the latest news, stock 
quotes, or other data. 


e Create a form, and then instantly read, process, and respond to the data the user enters 
in the form. 


For More Information See Dynamic HTML, online in MSDN Library Visual Studio 6.0. 


Data-Centric Applications 


A data-centric application, for the purposes of this book, is an application that relies on a 
connection to a database, where the bulk of its processing involves querying a database and 
returning results. You can use Visual Studio tools to build data-centric applications of 
nearly any size, small to large. Using the development skills you already possess, you can 
create powerful data-centric applications using the latest data access technologies. One of 
the technologies that you have probably heard about is ActiveX Data Objects (ADO). 


ActiveX Data Objects (ADO) 


ActiveX Data Objects (ADO) make it possible for your client applications to access and 
manipulate all types of data through any OLE DB provider. In addition to relational data, 
you can use ADO to access and manipulate multidimensional data, such as directory 
services. 


The primary benefits of ADO are ease of use, high speed, low memory overhead, and a 
small disk footprint. ADO supports key features for building client/server and Web-based 
applications. 
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ADO also features Remote Data Service (RDS), by which you can move data from a server 
to aclient application or Web page, manipulate the data on the client, and return updates to 
the server in a single round trip. Previously released as the Advanced Data Connector, 

RDS has been combined with the ADO programming model to simplify client-side data 
remoting. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Getting Started with ADO 
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Choosing the Right Tools for the 


This chapter looks at the role of each Microsoft Visual Studio development tool in 
application development. In addition to building Microsoft Windows applications, Visual 
Studio 6.0 can help you: 


e Build applications fast. 
e Build applications for the Web. 
e Build data-centric applications. 


Many features of the Visual Studio tools are specifically designed to help you with these 
tasks. This chapter looks at what these tools offer for building any application faster, for 
building Web applications, and for building data-centric applications. 


What This Chapter Won't Tell You 


This chapter will not recommend one tool over another. The factors that influence your 
choice of tools are varied and specific to each individual. Besides, the right tool for one 
person to use in building a Web application will not be the best choice for another person 
building the exact same kind of Web application. Why? Because of intangible but highly 
important factors such as: 


e Developer resources This is perhaps the single most important factor. If you have a 
staff of experienced Microsoft Visual Basic developers, for example, you'll want to 
work to their strength. Expecting them to switch to a new tool and to become 
competent overnight might not be realistic. 


e Available time On most development projects, time is of the essence. You might 
want to devote time to designing and testing a great application, not to learning the 
tools necessary to designing and testing that application. 


In the end, choosing a development tool depends as much on business needs and developer 
resources as it does on the feature set of any given tool. The sections in this chapter point 
out the strengths of each tool. 


Job 


Developing for Windows and the Web 11 


Chapter 2 Choosing the Right Tools for the Job 


Section Description 

Tools for Fast Development Describes how each Visual Studio tool supports fast development. 

Tools for Web Applications Describes how each Visual Studio tool supports building Web 
applications. 


Tools for Data-Centric Applications Describes how each Visual Studio tool supports building data- 
centric applications. 


Tools for Fast Development 


What does it mean to build applications faster? In Visual Studio, it means taking advantage 
of ways to write less code and to write code faster. To make it easier to write less code, 
Visual Studio tools provide wizards to help you create skeleton applications that you can 
customize with your own code. All the Visual Studio tools support the Component Object 
Model (COM), and you can reuse components that you write in any Visual Studio 
language. Visual Studio even includes ways for you to model your application visually, 
and then generate application code. 


To make writing code faster, all the Visual Studio tools offer visual development 
environments, IntelliSense® features such as statement completion, and quick access to 
documentation — not only product documentation, but the wealth of resources available 
on MSDN, the Microsoft Developer Network. 


This section looks at what each Visual Studio tool offers to support fast development. For 
more information, see any of the following topics in this section. 


e Fast Development in Visual Basic 

e Fast Development in Visual C++ 

e Fast Development in Visual FoxPro 
e Fast Development in Visual InterDev 


e Fast Development in Visual J++ 


Fast Development in Visual Basic 


Visual Basic offers a host of features to help you write code faster. These features include 
wizards, ActiveX controls, and automatic code completion. Wizards create Visual Basic 
projects for you that you can customize to your needs. ActiveX controls offer a way to 
reuse already-tested and working functionality that someone else programmed in your 
applications. Automatic code completion eliminates the need to memorize language 
syntax, parameters, properties, and methods. 
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Creating Projects Quickly with Wizards 


Visual Basic offers a full gallery of wizards that simplify many formerly complex tasks. 
These wizards are summarized in the following table. 


Wizard 
ActiveX Control Interface Wizard 


ActiveX Document Migration 
Wizard 


Add-in Designer (new for version 
6.0) 


Application Wizard (enhanced for 
version 6.0) 


Class Builder Utility (enhanced 
for version 6.0) 


Data Form Wizard (enhanced for 
version 6.0) 


Data Object Wizard 


Description 


Helps you create the public interface for a Visual Basic-generated 
ActiveX control after you have created the user interface. 


For more information, see ActiveX Control Interface Wizard online in 
MSDN Library Visual Studio 6.0. 


Helps you change existing forms into ActiveX documents, which are 
special ActiveX components. ActiveX documents can be placed and 
activated within ActiveX document containers, such as Microsoft 
Internet Explorer. 


For more information, see ActiveX Document Migration Wizard online 
in MSDN Library Visual Studio 6.0. 


Helps you start development by specifying your add-in's default load 
behavior, name, target application and version, and other properties. 


For more information, see Using Add-In Designer online in MSDN 
Library Visual Studio 6.0. 


Generates a new, fully functional application from which you can build 
a more complex application. 


For more information, see Application Wizard online in MSDN Library 
Visual Studio 6.0. 


Helps you build a class and collection hierarchy for a Visual Basic 
project. 


For more information, see Class Builder Utility online in MSDN 
Library Visual Studio 6.0. 


Generates Visual Basic forms that contain individual bound controls 
and procedures used to manage information derived from database 
tables and queries. 


For more information, see Data Form Wizard online in MSDN Library 
Visual Studio 6.0. 


Helps you generate code for COM data objects and user controls that 
display and manipulate data. 


For more information, see Data Object Wizard online in MSDN Library 
Visual Studio 6.0. 


Developing for Windows and the Web 13 


Chapter 2 Choosing the Right Tools for the Job 


Wizard Description 


Package and Deployment Wizard _ Helps you create application setup and distribution media. 


(new for version 6.0) For more information, see Package and Deployment Wizard online in 


MSDN Library Visual Studio 6.0. 
Property Page Wizard Helps you build property pages for user controls. 


For more information, see Property Page Wizard online in MSDN 
Library Visual Studio 6.0. 


Toolbar Wizard (new for version | Automatically opens when you add a toolbar to a form so that you can 
6.0) create customized toolbars. 


For more information, see Toolbar Wizard online in MSDN Library 
Visual Studio 6.0. 


Reusing Code with ActiveX Controls 


Visual Basic, Professional Edition contains more than 60 ActiveX controls that you can 
use to create your applications. An ActiveX control is an extension to the Visual Basic 
Toolbox. You can use ActiveX controls just as you would use any of the standard built-in 
controls, such as the CheckBox control. When you add an ActiveX control to your 
program, the control becomes part of the development and run-time environment and 
provides new functionality for your application. 


ActiveX controls leverage your skills as a Visual Basic programmer by retaining some 
familiar methods, events, and properties (such as the Name property), which behave as you 
would expect. But ActiveX controls also include methods and properties that greatly 
increase your flexibility and capability as a Visual Basic programmer. There are hundreds 
of ActiveX controls available for you to use in your applications. 


New ActiveX controls for this version include the Internet Explorer 4 controls, the ADO 
Data control, the CoolBar control, and the DataRepeater control. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 


e ActiveX Controls Overview 


Filling in the Blanks with Automatic Code Completion 


Visual Basic makes writing code much easier with features that can automatically fill in 
statements, properties, and arguments for you. As you enter code, the Visual Basic Code 
Editor displays lists of appropriate choices, statement or function prototypes, or values. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Editor Tab (Options Dialog Box) 
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Fast Development in Visual C++ 


Microsoft Visual C++ offers a host of features to help you write code faster. These features 
include wizards, ActiveX controls, and automatic code completion. Wizards create Visual 
C++ projects for you that you can customize to your needs. ActiveX controls offer a way 
to reuse already-tested and working functionality that someone else programmed in your 
applications. Automatic code completion eliminates the need to memorize language 
syntax, parameters, properties, and methods. 


Creating Projects Quickly with Wizards 


Some Visual C++ wizards work with the Microsoft Foundation Classes (MFC) application 
framework and the Active Template Library to create starter programs for you. Other 
wizards help you add functionality to your Visual C++ programs. 


Wizard Description 

ATL COM AppWizard Helps you create an Active Template Library (ATL) application. 
For more information, see Creating an ATL Project online in MSDN 
Library Visual Studio 6.0. 

Custom AppWizard Helps you create your own project type and add it to the list of available 
types. 


For more information, see Creating Custom AppWizards online in MSDN 
Library Visual Studio 6.0. 


DevStudio Add-in Wizard Helps you create add-ins to automate development tasks. Add-ins are in- 
process COM components (.dll files) written in Visual C++ or Visual 
Basic. 


For more information, see Overview: Add-ins for the Visual C++ 
Developer Studio online in MSDN Library Visual Studio 6.0. 


ISAPI Extension (Internet Server Helps you create an Internet Server Application Programming Interface 
API) Wizard (ISAPI) extension or filter. 


For more information, see Create an ISAPI DLL with the ISAPI 
Extension Wizard online in MSDN Library Visual Studio 6.0. 


Makefile Helps you create a MAKEFILE project. 


For more information see Create a MAKEFILE Project online in MSDN 
Library Visual Studio 6.0. 
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Wizard 
MFC ActiveX ControlWizard 


Description 


Helps you create an ActiveX control. Creates all necessary files, 


MFC AppWizard (enhanced for 
version 6.0) 


Utility Project 


Win32° Application 


Win32 Console Application 


Win32 Dynamic Link Library 


Win32 Static Library 
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including source and header files, resource files, a module-definition file, 
a project file, an object description language file, and so on. 


For more information, see Create a Program with the MFC ActiveX 
ControlWizard online in MSDN Library Visual Studio 6.0. 


Generates a complete suite of source files and resource files based on 
classes from the MFC library. There are two versions of this wizard, one 
that helps you create an MFC executable program and one that helps you 
create an MFC DLL. 


For more information, see Overview: Creating an MFC EXE Program or 
Overview: Creating an MFC DLL Program online in MSDN Library 
Visual Studio 6.0. 


Helps you create a utility project, which you can use as a container for 
files you build without a link step, such as a master project for 
subprojects. 


For more information, see Overview: Creating a Utility Project online in 
MSDN Library Visual Studio 6.0. 


Helps you create a Win32 program, an executable application written in 
C or C++ that uses calls to the Win32 application programming interface 
(API) instead of to MFC classes. 


For more information, see Overview: Creating a Win32 Program online 
in MSDN Library Visual Studio 6.0. 


Helps you create a console program using the Console API functions, 
which provide character-mode support in console windows. 


For more information, see Overview: Creating a Console Program online 
in MSDN Library Visual Studio 6.0. 


Helps you create a Win32 DLL; that is, a binary file written in C or C++ 
that uses calls to the Win32 API instead of to MFC classes. 


For more information, see Overview: Creating a Win32 DLL online in 
MSDN Library Visual Studio 6.0. 


Helps you create a static library; that is, a file containing objects and their 
functions and data, which is linked into your program when the 
executable file is built. 


For more information, see Overview: Creating a Static Library online in 
MSDN Library Visual Studio 6.0. 
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Reusing Code with ActiveX Controls 


Visual C++, Professional Edition contains many preregistered ActiveX controls that you 
can use to create your applications. These ActiveX controls are stored in the Gallery. The 
Gallery is a storage location for code you want to share or reuse. Two default folders are 
included with the Gallery as shipped: one for prepackaged Visual C++ components and 
another for preregistered ActiveX controls. 


You can use ActiveX controls just as you would use any of the standard built-in controls. 
When you add an ActiveX control to your program from the Gallery, the Gallery generates 
a programmatic interface called an ActiveX control wrapper. This wrapper makes it 
possible for the ActiveX control to communicate with your program. 


New ActiveX controls for this release include the Microsoft Internet Explorer 4.0 common 
controls. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Microsoft Foundation Class Library (MFC) 


Libraries at Your Fingertips with Automatic Statement 
Completion 


The Text editor now features Automatic Statement Completion, also known as 
IntelliSense. IntelliSense puts the MFC, Win32, and ATL libraries virtually at your 
fingertips, displaying class members, function prototypes, identifier declarations, and code 
comments at the mouse or cursor location where you are editing your code. Simple 
keystrokes insert code elements directly into the source code file you're working in. 
IntelliSense also completes recognized words for you, saving you from having to type 
lengthy class or member names repetitively. 


For More Information See About Automatic Statement Completion, in the Visual C++ 
User's Guide online in MSDN Library Visual Studio 6.0. 


Fast Development in Visual FoxPro 


Microsoft Visual FoxPro offers a host of features to help you write code faster. These 
features include wizards, a Component Gallery, the Visual FoxPro Foundation Classes, an 
Application Framework, and an Application Builder. Wizards help you quickly accomplish 
common tasks, such as creating forms, formatting reports, and setting up queries. The 
Component Gallery helps you reuse code by providing a central location for software 
objects such as class libraries, forms, buttons, and so on. The Visual FoxPro Foundation 
Classes are provided with the Component Gallery and help reduce coding by providing 
"out-of-the-box" functionality. The Application Framework makes it easier to develop 
Visual FoxPro applications by providing several common application objects. The 
Application Builder works with the Application Framework to help you add, edit, or 
remove tables, forms, and reports. 
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Accomplishing Common Tasks Quickly with Wizards 


Wizard Description 

Application Wizard (new) Creates a project and a Visual FoxPro Application Framework, and then 
opens the Application Builder so you can add a database, tables, reports, 
and forms. 


For more information, see Application Wizard (5.0) online in MSDN 
Library Visual Studio 6.0. 


Connection Wizards (new) Includes the Code Generation Wizard and the Reverse Engineering 
Wizard. These wizards help you manage transfers between Visual 
FoxPro class libraries and Microsoft Visual Modeler models. 


For more information, see Connection Wizards Overview online in 
MSDN Library Visual Studio 6.0. 


Cross-Tab Wizard Creates a cross-tab query, displaying the results of a query in a 
spreadsheet format. 


For more information, see Cross-Tab Wizard online in MSDN Library 
Visual Studio 6.0. 


Database Wizard (new) Uses predefined templates to help you create a database containing 
appropriate tables. After the wizard generates the database, you can add 
the database to a Project or to the Component Gallery or open the 
Database Designer to modify the database tables and relationships. 


For more information, see Database Wizard online in MSDN Library 
Visual Studio 6.0. 


Documenting Wizard (enhanced) Formats and produces text files from your code in projects and program 
files. For example, the wizard can indent your source code, capitalize 
reserved words and variables, and produce a report of the keywords in the 
program. 


For more information, see Documenting Wizard online in MSDN Library 
Visual Studio 6.0. 


Form Wizard (enhanced) Creates a form for data entry from a single table. The size of the form is 
based on your Maximum design area setting on the Forms tab of the 
Options dialog box. 


For more information, see Form Wizard online in MSDN Library Visual 
Studio 6.0. 
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Wizard 
Graph Wizard (enhanced) 


Import Wizard (enhanced) 


Label Wizard (enhanced) 


Local View Wizard 


Mail Merge Wizard (enhanced) 


One-To-Many Form Wizard 


One-To-Many Report Wizard 
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Description 


Creates a graph from a Visual FoxPro table using Microsoft Graph. The 
larger your table is, the longer it will take the wizard to process your 
graph. You might consider limiting the scope of records in a large table 
by creating a view before you run the Graph Wizard. 


For more information, see Graph Wizard online in MSDN Library Visual 
Studio 6.0. 


Imports data into Visual FoxPro tables from other file formats. 


For more information, see Import Wizard online in MSDN Library Visual 
Studio 6.0. 


Creates labels from a table. 


For more information, see Label Wizard online in MSDN Library Visual 
Studio 6.0. 


Creates views using native data. If you do not have a database open, you 
are prompted to open a database or create one. 


For more information, see Local View Wizard online in MSDN Library 
Visual Studio 6.0. 


Creates either a data source for a Microsoft Word merged document or a 
text file that can be used by any word processor. You must have a current 
version of Microsoft Word and Open Database Connectivity (QDBC) 
installed on your computer in order to create a Microsoft Word merged 
document. Visual FoxPro Setup can install ODBC. For information about 
merged documents, see Microsoft Word Help. 


For more information, see Mail Merge Wizard online in MSDN Library 
Visual Studio 6.0. 


Creates a form for data entry from two related tables. The size of the 
form is based on your Maximum design area setting on the Forms tab of 
the Options dialog box. 


For more information, see One-To-Many Form Wizard online in MSDN 
Library Visual Studio 6.0. 


Creates a report that groups records from a parent table with records from 
a child table. The wizard prompts you with simple questions as you go 
through a brief series of steps, in which you specify the table and fields 
that you want to use to create controls on your report. 


For more information, see One-To-Many Report Wizard online in MSDN 
Library Visual Studio 6.0. 
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Wizard 
Oracle Upsizing Wizard 


PivotTable Wizard (enhanced) 


Query Wizard 


Remote View Wizard 
(enhanced) 


Report Wizard (enhanced) 
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Description 


Creates an Oracle database that duplicates, as much as possible, the 
functionality of a Visual FoxPro database. You can use the Oracle 
Upsizing Wizard to: 


e Move local data to a remote server. 


e Transform local base tables and local views into remote base tables 
and remote views. 


e Migrate a local application to a client/server application. 


For more information, see Oracle Upsizing Wizard online in MSDN 
Library Visual Studio 6.0. 


Creates pivot tables. Pivot tables are interactive worksheet tables. With 
them, you can summarize and analyze data from existing tables. You can 
choose either to save a pivot table directly in Microsoft Excel or to add 
one as an object on a form. You must have Microsoft Excel with 
Microsoft Query installed on your computer in order to create a pivot 
table. For more information about pivot tables, see Microsoft Excel Help. 


For more information, see PivotTable Wizard online in MSDN Library 
Visual Studio 6.0. 


Creates a selection of records based on some rules you specify. 


For more information, see Query Wizard online in MSDN Library Visual 
Studio 6.0. 


Creates views using remote data (ODBC). You must have an existing 
database to store your view in, as well as an existing data source or 
connection. If you do not have a database open, you are prompted to 
select an existing database or create one. 


For more information, see Remote View Wizard online in MSDN Library 
Visual Studio 6.0. 


Creates reports using one free table or one table or view in a database. 
The wizard prompts you with simple questions as you go through a brief 
series of steps, in which you specify the source and fields that you want 
to use to create controls on your report. 


For more information, see Report Wizard online in MSDN Library Visual 
Studio 6.0. 


Wizard 


Sample Wizard (new) 


Setup Wizard (enhanced) 


SQL Server Upsizing Wizard 


Table Wizard (enhanced) 


Web Publishing Wizard (new) 
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Description 


This sample wizard is a demonstration of a do-it-yourself wizard that is 
created by using the files in the Wzsample folder. The Sample Wizard 
creates an HTML document using data from a table or view. 


For more information, see Sample Wizard online in MSDN Library 
Visual Studio 6.0. 


Creates distribution disks from the files in your distribution tree. 


For more information, see Setup Wizard online in MSDN Library Visual 
Studio 6.0. 


Creates a SQL Server database that duplicates, as much as possible, the 
functionality of a Visual FoxPro database. You can use the SQL Server 
Upsizing Wizard to: 


e Move local data to a remote server. 


e Transform local base tables and local views into remote base tables 
and remote views. 


e Migrate a local application to a client/server application. 


For more information, see SQL Server Upsizing Wizard online in MSDN 
Library Visual Studio 6.0. 


Creates tables based on typical table structures. The Table Wizard lets 
you select a table that fits your needs from the list of sample tables. You 
can customize the table's structure and fields as you step through the 
wizard. You can also modify the table later after the wizard has saved the 
table. 


For more information, see Table Wizard online in MSDN Library Visual 
Studio 6.0. 


Helps you display data from a table or view in an HTML document. You 
can use or share the file that the Web Publishing Wizard creates in your 
browser or edit it in a text editor. 


For more information, see Web Publishing Wizard online in MSDN 
Library Visual Studio 6.0. 
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Reusing Code with the Component Gallery and Visual FoxPro 
Foundation Classes 


The Component Gallery is a new tool that helps you to group and organize objects such as 
class libraries, forms, buttons, and so on, into object, project, application, or other 
groupings. These visual groupings are dynamically customizable so that you can use, 
duplicate, or rearrange components among several classifications within the Component 
Gallery. The Component Gallery also contains new Visual FoxPro foundation classes that 
provide "right-out-of-the-box" functionality. 


The Visual FoxPro Foundation Classes provide common database development tools and 
structures, extensible generic components, including those that enhance Web page 
development, and wrappers for system application programming interface (API) functions, 
among other things. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 


e Visual FoxPro Foundation Classes A-Z 


Building Applications Quickly with Application Framework 
and Application Builder 


The Application Framework (enhanced for version 6.0) is designed to make it easier to 
develop Visual FoxPro applications. An Application Framework includes the project file 
and a starter class library subclassed from the Visual FoxPro base classes, ready for you to 
populate with new or existing tables and documents. You can access the Application 
Framework through the Application Wizard or through the New Application item of the 
Component Gallery. 


The enhanced Application Framework provides the project file, main program file, main 
menu, and Application object, as in the previous version, and adds a master Include file to 
assist in localization, an optional configuration file used for applications such as top-level 
forms to implement settings such as SCREEN=OFF, use of the ProjectHook class for 
controlling events related to the project, and an Application Meta table for holding 
information used by the ProjectHook class and the Application Builder. 


The Application Builder creates, and then opens, an Application Framework in an open 
project. You can then add, edit, or remove tables, forms, and reports. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Enhanced Application Framework 

e Application Wizard 

e Component Gallery 


e Application Object 
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e ProjectHook Object 
e Application Builder 


Fast Development in Visual InterDev 


Microsoft Visual InterDev offers several features to help you create Web sites faster. These 
features include wizards, design-time controls, a cascading style sheet (CSS) editor, a new 
WYSIWYG page editor, and automatic statement completion. Wizards create Visual 
InterDev projects for you that you can customize to your needs. Design-time controls make 
it easy to integrate sophisticated functionality into your Web applications. The new editors 
shield you from raw cascading style sheet or HTML code and provide immediate visual 
feedback on the changes you make. Automatic statement completion eliminates the need to 
memorize scripting syntax, methods, and properties. 


Creating Projects Quickly with Wizards 


Visual InterDev provides the following wizards to help you with common tasks: 


Wizard Description 

Sample Application Wizard Installs the Visual InterDev Gallery sample application or third-party Web 
applications. 
For more information, see Sample Application Wizard in MSDN Library 
Visual Studio 6.0. 

Web Project Wizard Creates anew Web project, connects to an existing Web application, or 


creates anew Web application. 


For more information, see Web Project Wizard online in MSDN Library 
Visual Studio 6.0. 


Integrating Sophisticated Functionality with Design-Time 
Controls 


You can create Web pages with data-bound controls as easily as dragging controls to the 
page and setting a few properties. You can configure these controls to be optimized for 
broad reach through server processing or take advantage of the features of Microsoft 
Internet Explorer 4.0. Design-time controls take advantage of the new Visual InterDev 
scripting object model so that you can easily integrate sophisticated functionality into your 
Web applications. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e The Scripting Object Model 
e Scripting with Design-Time Controls and Script Objects 
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Editing Cascading Style Sheets Easily 


You can edit style sheets easily in the Cascading Style Sheets (CSS) editor. You can create 
or modify style sheets for a set of Web pages and preview how your pages would look if 
the current style sheet were applied. The CSS editor provides an easy-to-use interface for 
editing style sheets that shields you from editing the raw CSS text. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Editing Style Sheets 
e CSS Editor Window 


Creating Content Using Design View 


With this release, Visual InterDev introduces a new editor that includes a Design view for 
creating content ina WYSIWYG workspace. In addition to working in Design view, you 
can write script in the Source view and preview your file in Quick view. You can switch 
between these different views of your file with just a mouse click; the views are all shown 
on tabs at the bottom of the editor window. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Editing Basics 
e Editing Modes 


Writing Fast and Accurate Scripting Code 


Visual InterDev makes scripting faster and more accurate for you in this release by 
including IntelliSense statement completion. IntelliSense helps you create error-free script 
statements by presenting you with the names of available methods and properties as soon 
as you type in the name of an object. 


For More Information See Editing Modes, online in MSDN Library Visual Studio 6.0. 


Fast Development in Visual J++ 


Microsoft Visual J++ offers a host of features to help you write code faster. These features 
include wizards and builders, the Windows Foundation Classes (WFC) Designer, an 
Object Browser, and automatic code completion. Wizards and builders create Visual J++ 
projects for you that you can customize to your needs. The WFC Designer helps you create 
form-based applications with Visual J++. The Object Browser helps you find information 
about Java or COM-based components. Automatic code completion eliminates the need to 
memorize language syntax, parameters, properties, and methods. 
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Creating Projects Quickly with Wizards and Builders 


Visual J++ provides several wizards and builders to help you develop your applications. A 
wizard creates a new file through a step-by-step process; a builder helps you modify 
existing files in your project. The following table lists the wizards and builders included in 
Visual J++. 


Wizard Description 


Application Wizard Creates a Windows Foundation Classes for Java (WFC) application 
containing a form. You have the option of binding the form to the fields 
in a database. 


For more information, see Creating a Project with the Application Wizard 
online in MSDN Library Visual Studio 6.0. 


WFC Component Builder Adds properties and events to WFC components. 


For more information, see Modifying Components with the WFC 
Component Builder online in MSDN Library Visual Studio 6.0. 


Data Form Wizard Automatically generates a form that is bound to the fields in a database. 
The Data Form Wizard supports Microsoft® Access .mdb files, as well as 
databases that can be accessed through ODBC. 


For more information, see Running the Data Form Wizard online in 
MSDN Library Visual Studio 6.0. 


J/Direct Call Builder Inserts Java definitions for the Win32 API functions into your code, 
along with the appropriate @dl].import tags. 


For more information, see J/Direct Call Builder online in MSDN Library 
Visual Studio 6.0. 


Creating Form-Based Applications with WFC Designer 


The rapid application development (RAD) features of the WFC Designer make it easy to 
create form-based applications with WFC. You can use the Toolbox to quickly drop WFC 
components onto your form and configure their properties using the Properties window. 


For More Information See Designing Forms, online in MSDN Library Visual Studio 6.0. 


Finding Information with the Object Browser 


You can quickly find information about Java or COM-based components, without adding 
them to your project — even if you don't have the source code for these components. The 
Object Browser displays the classes, properties, methods, events, and constants available 
for packages and libraries. 
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For More Information See Browsing Packages and Libraries with the Object Browser, 
online in MSDN Library Visual Studio 6.0. 


Writing Accurate Code 


Visual J++ has enhanced the Text editor with several new timesaving features such as 
statement completion, dynamic syntax checking, and two-way interaction between the Text 
editor and Class Outline. Statement completion displays member lists and parameter 
information as you type. Dynamic syntax checking provides visual clues in the form of red 
squiggly lines and error tips as you build your program's statements. Two-way interaction 
between the Text editor and the Class Outline means that Visual J++ updates the Class 
Outline tree view whenever you add a method, member variable, or class to a source file. 


For More Information See Managing Files with the Text Editor, online in MSDN Library 
Visual Studio 6.0. 


Tools for Building Web Applications 


A Web application can be almost anything, from an Active Server Pages (ASP) file that 
returns different information depending on how a user fills out a form to a multi-tiered 
application that queries a database and returns information, such as the Island Hopper 
News sample. Visual Studio makes it possible for you to use the development skills you 
‘already have to create powerful Web solutions using the latest Web technologies. 


The Visual Studio tools work together to help you create integrated Web applications. You 
can leverage Visual Basic and Visual C++ to build server-side Web components, and then 
use Visual InterDev to integrate these components into a thin-client, HTML-based 
application. Also, many of the Visual Studio tools are enhanced this release to make it 
easier to build data-centric Web applications. 


This section looks at what each Visual Studio tool offers to support Web applications. For 
more information see any of the following topics. 


e Building Web Applications with Visual Basic 

e Building Web Applications with Visual C++ 

e Building Web Applications with Visual FoxPro 
e Building Web Applications with Visual InterDev 
e Building Web Applications with Visual J++ 
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Building Web Applications with Visual Basic 


You can use Visual Basic to build two different types of Web applications — Dynamic 
HTML (DHTML) applications and Microsoft® Internet Information Server (IIS) 
applications. DHTML applications do their processing on the client computer; IIS 
applications do their processing on the server computer. Additionally, Visual Basic makes 
it easy for you to incorporate other types of Internet functionality into your applications; 
for example, you can create and use ActiveX components, including ActiveX controls, 
documents, and code components. You can also use the WebBrowser control to display 
HTML or ASP-based pages within a Visual Basic form. 


The user interface in your Visual Basic Web application can consist of: 
e A series of HTML pages. 
e A mix of HTML pages and Visual Basic forms. 


e A Visual Basic form that uses controls that provide Internet functionality, such as the 
WebBrowser control. 


You do not have to code the HTML pages yourself. Often, HTML pages are coded by a 
Web designer instead of a developer. You can focus on using your Visual Basic 
programming skills to write code that interacts with and uses HTML. 


This section provides an overview of the following Visual Basic Web application features. 
e IIS applications 

e DHTML applications 

e Downloading ActiveX components 


For More Information See What's New in Internet Features, online in MSDN Library 
Visual Studio 6.0. 


IIS Applications 


An IIS application (named after Internet Information Server) is a Visual Basic application 
that uses both HTML and compiled Visual Basic code to create a browser-based 
application. IIS applications can run in any browser and on either a corporate intranet or 
the Internet, making it possible to reach a broad audience. 


IIS applications physically reside on a Web server, where they receive requests from the 
browser, run the code associated with the requests, and return responses to the browser. 
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In addition to simply intercepting a user request and returning an HTML page, you can 
create IIS applications that perform more advanced functions, such as: 


¢ Querying databases, writing information to and from records. 


e Retrieving HTML pages, and then replacing portions with dynamic content before 
sending them to the browser. 


e Dynamically creating HTML elements and generating events for those elements at run 
time. 


These advanced functions make it possible for you to write complex applications, with 
Visual Basic code replacing scripting, Common Gateway Interface (CGI) processing, and 
other methods of Internet application development. 


Webclasses 


An IIS application is composed of an object called a webclass, which contains a series of 
resources called webitems. The webclass acts as the central functional unit of the 
application, processing data from the browser and sending information to the users. You 
define a series of Visual Basic procedures that determine how the webclass responds to 
these requests. The webitems are the HTML pages and other data the webclass can send to 
the browser in response to a request. 


What About Active Server Pages (ASP) Applications? 


ITS applications and ASP applications are quite similar. You can use both technologies to 
create dynamic, interactive Web applications that reside on the server. Both technologies 
are capable of calling other code components to perform complex business processing. The 
major difference between the two, aside from the fact that you code IIS applications using 
Visual Basic and you code ASP applications using scripting code (either VBScript or 
JScript), is that IIS applications separate the user interface (HTML or Active Server Pages) 
from the application code. ASP applications combine the application code and HTML on 
the same page. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Advantages of IIS Applications 

e An Introduction to Webclasses 

e IIS Application Development Process 

e Webclass Events 

e Responding to Events in IIS Applications 

e State Management in IIS Applications 
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DHTML Applications 


A DHTML application is a Visual Basic application consisting of a combination of 
Dynamic HTML and compiled Visual Basic code. Together these elements create an 
interactive, browser-based application. DHTML applications are named for Dynamic 
HTML, a technology extension of Internet Explorer 4.0 and later that makes it possible for 
users and developers to interact with Web pages in new ways. DHTML applications 
require Internet Explorer 4.01 or later. 


DHTML applications reside on the browser computer, where they interpret and respond to 
actions the end user performs in the browser. 


Although a DHTML application can be as simple as a single HTML page that uses Visual 
Basic code and the Dynamic HTML object model to respond to objects on the page, you 
can create more complicated DHTML applications that perform functions like the 
following: 


e Retrieve data from the user and then use that data to query a database. 
e Update a page's appearance and behavior. 
e Create HTML elements and insert them into a page in response to user requests. 


DHTML applications use Visual Basic code to replace scripting, CGI processing, and 
other methods of Internet application development. More importantly, DHTML 
applications offload most of the processing from the server to the browser computer. 


In addition to writing Visual Basic code to connect to a Web page, you can use a special 
designer in Visual Basic to create Web pages that act as the user interface of your 
application. You can also edit an existing Web page in Visual Basic. This way, if you're 
familiar with HTML or want to create your own pages, you can use the DHTML Page 
Designer to do so, or you can have someone else create your pages and just add the pages 
to your application. 


The user interface for a DHTML application consists of HTML pages. HTML pages are 
analogous to forms, in the sense that they contain the visual elements that make up your 
application's user interface. You can place some of the same items on an HTML page as 
you can on a form, including text, buttons, check boxes, and option buttons. However, 
where forms require just the Visual Basic run-time DLL, Msvbm60.dll, in order to display 
at run time, HTML pages additionally require hosting in either a Web browser or the 
Internet Explorer 4.0 WebBrowser control. 
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Differences Between IIS Applications and DHTML Applications 


IIS applications and DHTML applications are similar in the sense that both types of 
applications can respond to events generated by an HTML page. Significant differences 
between the two include: 


e Dependency DHTML applications require Internet Explorer 4.0 or later; IIS 
applications are operating system- and browser-independent. 


e Object model DHTML applications use the Dynamic HTML object model for 
programming; IIS applications use the Active Server Pages object model. 


e Location DHTML applications reside and do most of their work on the browser 
computer; ITS applications reside and do most of their work on the server computer. 


IIS applications are intended for use on either a large corporate intranet with multiple 
operating systems and browsers or the Internet; DHTML applications are intended for 
intranets where everyone uses Internet Explorer 4.0 or later. 


Sample Applications 


Visual Basic includes two sample applications that demonstrate techniques for using 
DHTML in your applications. These applications are called DhaShowMe and PropBag. See 
the Visual Basic Samples page online in MSDN Library Visual Studio 6.0 for information 
on how to install the samples. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Advantages of DHTML Applications 

e DHTML Application Development Process 

e Designing Pages for DHTML Applications 

e Managing State in DHTML Applications 


Downloading ActiveX Components 


With Visual Basic, you can use ActiveX technology to create components that you can use 
on HTML pages or as alternatives to HTML pages. These components can include controls 
(.ocx files), code components (.exe and .dll files) that run on the client, or ActiveX 
documents (.vbd files) that function much like an HTML page. All of these components 
help you create Internet solutions that meet your business needs. Internet component 
download delivers these ActiveX solutions to users through an Internet browser. 
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Visual Basic offers support to help you package and download your ActiveX controls, 
code components, and ActiveX documents. This support includes: 


e The Package and Deployment Wizard, which can help you prepare your software for 
Internet component download. 


e The License Package Authoring tool, which can help you create license files for HTML 
pages. 

For More Information See the following topics online in MSDN Library Visual Studio 6.0. 

e Steps to Prepare Your Component for Download 

e How Internet Component Download Works 

e File Packaging with the Package and Deployment Wizard 


e Licensing for ActiveX Components 


Building Web Applications with Visual C++ 


Visual C++ Internet programming support includes Microsoft Foundation Class (MFC) 
classes for writing ActiveX controls, code components, and Active documents; MFC 
classes for retrieving files and information using Internet protocols such as FTP and HTTP; 
and MFC classes for extending Web servers with custom programming. You can use your 
knowledge of Visual C++ to create high-performance server-side components that perform 
complex business processing as part of your Web applications. 


New with this release are features that make it possible for you to host Dynamic HTML 
within your MFC applications, ATL support for Dynamic HTML, and MFC wrappers for 
the Internet Explorer Common Controls. 


This section provides an overview of the following Visual C++ features for developing 
Web applications. 


e The CHtmlView class 
e ATL support for Dynamic HTML 
¢ MFC wrappers for the Internet Explorer Common Controls 


For More Information See Internet Topics, online in MSDN Library Visual Studio 6.0. 
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Dynamic HTML Hosting with CHtmlView 


The CHtml View class makes it possible for you to host Dynamic HTML within your MFC 
applications. With CHtml View, your application's view can display HTML pages that 
contain Dynamic HTML just as a Web browser would display them. CHtmlView provides 
many browser features, including: 


e Browsing Web sites, as well as folders in the local file system and on a network. 
e Browsing via point-and-click hyperlinks. 
e Browsing via Uniform Resource Locator (URL) navigation. 


¢ A history list that users can use to browse forward and backward through previously 
browsed sites, folders, and documents. 


e Favorites (bookmarks). 

e Security features. 

For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Web Browser-Style Applications 

e CHtmlView 


ATL Support for Dynamic HTML Controls 


You can create an ATL project that displays a control with Dynamic HTML capability in a 
Web browser or other container. An ATL HTML control hosts the WebBrowser control 
and makes it possible for you to specify the user interface of the control using HTML. The 
control sets up a mechanism to communicate between C++ code and HTML. 


A DHTML control is similar to any other ATL control, except that the control includes an 
additional dispatch interface for communicating from the HTML user interface and an 
HTML resource file. You can communicate with the HTML user interface using the 
DHTML object model. To communicate from HTML to your C++ code, use the 
window.external mechanism provided by DHTML. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Identifying the Elements of the DHTML Control Project 

e Calling C++ Code from DHTML 

e Creating a DHTML Control 

e Testing the DHTML Control 

e Modifying the DHTML Control 

e Testing the Altered DHTML Control 
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MFC Wrappers for Internet Explorer Common Controls 


MFC provides support for the latest Internet Explorer common controls in classes such as 
CComboBoxEx, CDateTimeCtrl, CIPAddressCtrl, and CMonthCalCtrl. You can access 
these controls from the Controls toolbar in the Dialog Editor. The following table provides 
more information about each of these classes. 


Class 
CComboBoxEx 


CDateTimeCtrl 


CIPAddressCtrl 


CMonthCalCtrl 


Control 


Extended combo box 


Date and time picker 


Similar to an edit control 


Month calendar 


Description 


Extends the combo box control by providing support 
for image lists. 


Supports either an extended edit control or a simple 
calendar interface control, both of which make it 
possible for a user to choose a specific date or time 
value. 


Supports an edit box for manipulating an Internet 
Protocol (IP) address. 


Supports a simple calendar interface control that allows 
a user to select a date. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Using CComboBoxEx 
e Using CDateTimeCtrl 


e ClPAddressCtrl 


e Using CMonthCalCtrl 


Building Web Applications with Visual FoxPro 


With Visual FoxPro support for building Web applications, you can create Visual FoxPro 
Active Document applications, create automation servers, use GIF and JPEG graphics file 
formats, and use a Web Publishing wizard. 


Visual FoxPro Active Document Applications 


An Active Document is a Windows-based, non-HTML application embedded in a browser. 
With Active Documents, you can access all the functions of the application from your 
desktop browser, instead of having to install the application itself. A Visual FoxPro Active 
Document application is just like any other Visual FoxPro application: you can work with 
forms, reports, and labels, instantiate classes, execute code, and manipulate data. However, 
Visual FoxPro Active Document applications offer the significant advantage of being 
hosted in an Active Document container, such as Internet Explorer. 
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For More Information See Active Documents, online in MSDN Library Visual Studio 6.0. 


Automation Servers 


With Visual FoxPro, you can create automation servers (formerly called OLE servers) that 
package code to perform tasks common to many applications, or that implement complex 
business rules. These tasks and rules are then available to other programmers in your 
company, and to users of tools that support automation. These automation servers work 
with products and technologies such as the Microsoft® Transaction Server (MTS), 
Microsoft Visual Basic, and Active Server Pages. 


For More Information See FoxISAPI: An OLE Server Sample, online in MSDN Library 
Visual Studio 6.0. 


Support for GIF and JPEG Graphics File Formats 


To support Internet interoperability, Visual FoxPro has been enhanced to support GIF and 
JPEG graphics file formats. Generally, any item in Visual FoxPro that previously 
supported the bitmap format now supports GIF and JPEG as well. 


For More Information See GIF and JPEG Graphics Support, online in MSDN Library 
Visual Studio 6.0. 


Web Publishing Wizard 


The Visual FoxPro Web Publishing wizard generates an HTML file from records in a data 
source that you specify. This is a quick way for you to provide Web access to data stored 
in a Visual FoxPro database. 


For More Information See Web Publishing Wizard, online in MSDN Library Visual Studio 
6.0. 


Building Web Applications with Visual InterDev 


Visual InterDev is exclusively designed to help you quickly create powerful Web 
applications. In Visual InterDev, you can easily create a new Web on a Web server, create 
new ASP or HTML files, connect to and manage a database, and integrate the database 
with your Web pages. Local and Master Webs make it possible for you to work and test in 
isolation, and then integrate with a Web application under development by several 
developers. Web application development is faster, richer, and more robust with new 
features in this version that include: 
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e The scripting object model. 

e The graphical Site Designer. 

e Dynamic HTML (DHTML) support. 
e Developer isolation. 

e Debugging tools. 


e Deployment features. 


Scripting Object Model 


The scripting object model simplifies Web application development and reduces the 
complexity and quantity of scripting required to write applications that span the browser 
and server computers. The scripting object model defines a set of objects with events, 
properties, and methods that you can use to create and script your application. You can 
create the user interface for your Web application using design-time controls, and then 
write script to control the application. If you are familiar with creating Visual Basic or 
Microsoft Access applications but new to Visual InterDev, the scripting object model will 
seem quite familiar. Visual InterDev also includes a debugger to assist you in making sure 
your scripts are error-free and work the way you want. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Scripts in Web Applications 

e The Scripting Object Model 

e The Script Debugging Process 

e Scripting with Design-Time Controls and Script Objects 


Site Designer 


The graphical Site Designer is available to help you prototype and build Web sites quickly. 
With the Site Designer, you can create pages, links, navigation, and hierarchy — all within 
an easy-to-use drag-and-drop interface. You create site diagrams in Site Designer. When 
you are satisfied with the appearance of your site, you save the diagram. At that point, Site 
Designer adds the pages you have created and updates the navigational links. 


At any point you can maintain or update your site by changing the site diagram using Site 
Designer. All you need to do is arrange the pages in a drag-and-drop operation. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Site Design 
e Designing a Web Site 
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Dynamic HTML 


Visual InterDev supports Dynamic HTML (DHTML) in Internet Explorer 4.0. You can 
use the Visual InterDev editor to create script for DHTML objects and events. IntelliSense 
statement completion in the editor, as well as a display of the DHTML object model 
hierarchy in the Navigation pane, help you create quick, accurate scripts. 


For More Information See Writing Script for Script Objects, online in MSDN Library 
Visual Studio 6.0. 


Developer Isolation 


You can work on local versions of project files, which gives you the ability to test and 
debug your files before updating the master server. You can also work in master mode, 
where your changes are automatically saved both locally and to the master server. Visual 
InterDev is also integrated with Microsoft® Visual SourceSafe™, which makes it easy for 
a team of developers to work on a single Web application. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Working Locally 
e Working with Multiple Developers 


e Project Architecture 


Debugging Tools 


Visual InterDev includes a debugger that helps you test and debug script and Java 
components. You can use the debugger with VBScript, JScript™, and applications written 
in the Java language that are run using the Microsoft Virtual Machine for Java. 


For More {Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Debugging Script 

e The Script Debugging Process 

e Debugging Your Pages 


Deployment 


This release of Visual InterDev includes deployment features for middle-tier COM server 
components. These features support building and deploying component-based Web 
applications, including those integrated with Microsoft Transaction Server. You can copy 
your Web application to a production server with just a mouse click in this version of 
Visual InterDev. 
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For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Web Application Deployment 
e Deploying and Maintaining Web Applications 


Building Web Applications with Visual J++ 


Microsoft Visual J++ provides a great development environment for Java programmers. 
Enhancements to this release of Visual J++ that make building Java-enhanced Web 
applications even easier include: 


e Support for Dynamic HTML using the Windows Foundation Classes for Java (WFC). 
e Packaging and Deployment support for Web applications. 


e Integration with Visual InterDev, including a shared development environment and the 
ability to combine Visual J++ and Visual InterDev projects into a shared solution. 


e Full-featured HTML support. 


Dynamic HTML Support 


This release of Visual J++ introduces the Windows Foundation Classes for Java (WFC), a 
new applications framework that provides access to the Windows API. WFC also wraps 
the Dynamic HTML object model, implemented in Internet Explorer 4.0, in the wfc.html 
package. 


For More Information See Programming Dynamic HTML in Java, online in MSDN Library 
Visual Studio 6.0. 


Packaging and Deployment Support 


New packaging and deployment support makes it easy to deploy your Web applications 
with a click of the mouse. 


For More Information See Packaging and Deploying Projects, online in MSDN Library 
Visual Studio 6.0. 


Integration with Visual InterDev 


This release of Visual J++ shares a development environment with Visual InterDev. 
Beyond that, it's possible to combine both Visual J++ and Visual InterDev projects into a 
single solution. 


For More information See Creating a Multi-Project Solution, online in MSDN Library 
Visual Studio 6.0. 
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Full-Featured HTML Support 


The HTML editor in Visual J++ can help you insert links and bookmarks into your Web 
pages, create and modify HTML tables, and create scripts. The editor, which Visual J++ 
shares with Visual InterDev, provides three views for working with Web pages: Source 
view for editing HTML tags; Design view for working ina WYSIWYG environment; and 
Quick view to see your Web page as it will look in a browser. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 


e Editing Basics 
e Editing Modes 


Implications of Web Technologies 


This topic explains some of the implications of the decisions you make about 
implementing Web applications and choosing technologies. 


Web Implementation Choices 


Required server 
infrastructure 


Required client 
infrastructure 


Advantages 


Client-side ActiveX controls Server-side COM 


Server platform 
independent. 


32-bit Internet Explorer 
browser (Windows NT 
4.0, Windows NT 5.0, 
Windows 95, Windows 
98). 


Reusable client 
component. Can take 
maximum advantage of 


Windows 32-bit desktops. 
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components 


DHTML 


Microsoft Windows NT® Server platform 


Server, Windows NT® 
Workstation, or 
Windows 95 or later. 


Client platform 
independent. 


Reusable server 
component. Can be used 
independently of target 
client. 


independent. 


Internet Explorer 4.0 
(Macintosh, Unix, 
Windows 95, Windows 
3.1, Windows NT). 


Dynamic client-side 
functionality based on 
W3C standards; cross- 
platform. 
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Web Technology Implications 


Client-side ActiveX controls Server-side COM DHTML 
components 

Visual Basic Easy to build and reuse Quickest way to develop Can use Visual Basic 6.0 
using Visual Basic forms _ reusable business rule DHTML editor as 
and the Visual Basic components. alternate forms engine 
language. for Visual Basic 

applications (Win32 
clients only). 

Visual C++ Build lightest-weight, Build lightest-weight, DHTML classes make it 
fastest controls with fastest and most possible for server-side 
complete threading options scaleable components and client-side 
using ATL. using ATL. components to generate 

and manipulate DHTML 
interfaces. 

Visual FoxPro Can consume, but not Build server components Not applicable. 
build controls. Easily based on the DBASE 
integrate ActiveX controls language. 
into DBASE applications. 

Visual tnterDev Can consume, but not Can consume, but not Best tool to create cross- 
build ActiveX controls. build, server-side COM __ platform DHTML, with 
Easily integrate ActiveX | components. Easily most complete scripting 
controls into Web pages integrate server COM and Web site 
using WYSIWYG editor | components using Active management support. 
and scripting tools. Server Pages and 

scripting support. 

Visual J++ Easily build and reuse Build server components DHTML Windows 
client-side ActiveX based on the Java Foundation Classes make 
controls using Visual J++ language. it easy to generate and 
6.0 visual forms designer manipulate DHTML 
based on Windows interfaces. 

; Foundation Classes for 
Java. 


° 


Tools for Building Data-Centric Applications 


You could argue that any application is data-centric, for what is an application without 
data? In this section, "data-centric application" is used in a narrower sense to describe an 
application that relies on a live connection to a database, where the bulk of its processing 
involves querying a database and returning results. 
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Data access is the primary issue behind data-centric applications. How do you access the 
data you need? Which of Microsoft's many data access technologies should you use, and 
which of the Visual Studio tools supports which of the data access technologies? Data 
access is a large subject, one that needs a lot more discussion than what is presented here. 
If you're interested in all the details about data access, see Data Access and Security 
Strategies online in Visual Studio Developing for the Enterprise. 


This section looks at what each Visual Studio tool offers to support data access and data- 
driven applications. For more information see any of the following topics in this section. 


e Building Data-Centric Applications with Visual Basic 

e Building Data-Centric Applications with Visual C++ 

e Building Data-Centric Applications with Visual FoxPro 
e Building Data-Centric Applications with Visual InterDev 


e Building Data-Centric Applications with Visual J++ 


Building Data-Centric Applications with Visual 
Basic 


In this release, Visual Basic offers a host of new and enhanced features that, together, 
make data access using Visual Basic easier than ever before. Visual Basic supports 
ActiveX Data Objects (ADO) 2.0, Microsoft's new, high-level interface to all kinds of data. 
You can create ADO objects at design-time using the updated Data Environment Designer. 
You can access the entire structure of a database on a connection through the Data View 
Window and the Visual Database Tools. Visual Basic also offers new and updated controls 
specifically for working with data. 


This section provides an overview of the following Visual Basic data access features. 
e Support for ActiveX Data Objects (ADO) 2.0 

e Data Environment designer 

e Data View window 

e Visual Database Tools integration 


e New and enhanced controls 


ADO 2.0 


The new release of ADO features a simpler object model, better integration with Microsoft 
and non-Microsoft technologies, a common interface for both local and remote data access, 
remotable and disconnected recordsets, a user-accessible data binding interface, and 
hierarchical recordsets. 
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For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Getting Started with ADO 2.0 


e Search online for "ActiveX Data Objects in Visual Basic" 


Data Environment Designer 


The Data Environment designer helps you visually create and manipulate ADO 
connections and commands at design-time. In addition to supporting all of the functionality 
of the UserConnection designer, the Data Environment designer supports new features that 
make it easier to access your data, such as multiple Connection objects, support for OLE 
DB data sources, and OLE drag-and-drop support, so you can drag fields and tables from 
the Data Environment onto a form or the Data Report ActiveX designer. 


For More Information See About the Data Environment Designer, online in MSDN Library 
Visual Studio 6.0. 


Data View Window 


The Data View window contains a list of all the database connections currently available to 
your project. You can see the entire structure of the database using the Data View window, 
which provides the means to use the Microsoft Visual Database Tools to browse and edit 
data from tables and views. In addition to inspecting the structure of your database, you 
can drag objects from the Data View onto the Data Environment for quickly creating ADO 
recordset commands. 


For More Information See Managing Databases in Data View, online in MSDN Library 
Visual Studio 6.0. 


Visual Database Tools Integration 


The Microsoft Visual Database Tools (Database Designer and Query Designer) provide a 
visual interface to help you create and modify database structures (schemas) and queries. 
You can create Microsoft® SQL Server™ and Oracle database tables, use drag-and-drop 
operations to create views, and automatically change column data types. 


Visual Basic, Professional Edition includes a subset of the Visual Database Tools features. 
With Visual Basic, Professional Edition, you can create queries, edit queries, and execute 
stored procedures. 


For More Information See Introducing Microsoft Visual Database Tools, online in MSDN 
Library Visual Studio 6.0. 
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New and Enhanced Controls 


The following controls are all designed to help you solve data access issues in your 


applications. 
Control Purpose 
ADO Data Control (new) Uses ADO to create connections between data-bound controls and data 


providers. 


For more information, see Using the ADO Data Control online in 
MSDN Library Visual Studio 6.0. 


DataCombo and DataList Controls Provide a combo box and a list box that you can fill from a database 

(new) field from the data control to which they are bound. Similar to the 
DBCombo and DBList controls, the DataCombo and DataList controls 
make it possible for you to switch data sources dynamically. 


For more information, search online for "Using the DataCombo and 


DataList Controls". 

DataGrid Control (new) Views and edits recordsets using a spreadsheet-like interface. 
For more information, see Using the DataGrid Control online in MSDN 
Library Visual Studio 6.0. 

DataRepeater Control (new) Provides a rich view of a database if you insert UserControls into the 


DataRepeater. The UserControls can contain TextBox, CheckBox, or 
other controls bound to data fields. 


For more information, see Using the DataRepeater Control online in 
MSDN Library Visual Studio 6.0. 


Hierarchical Flexgrid Control Displays hierarchical recordsets — recordsets created from several 
(new) different tables. You can view data from several related tables using 
clear, logically indented formatting in a single grid. 


For more information, see Using the Hierarchical Flexgrid Control 
online in MSDN Library Visual Studio 6.0. 


Building Data-Centric Applications with Visual C++ 


Visual C++ provides several ways to work with databases. You can directly call database 
API functions from the DAO or ODBC Software Development Kits (SDKs), or you can 
choose to use the Microsoft Foundation Class Library (MFC), and let the MFC DAO and 
ODBC classes simplify working with either database API. New features in this release of 
Visual C++ include support for ActiveX Data Objects (ADO) 2.0, Microsoft's new, high- 
level interface to all kinds of data; integration with the Microsoft Visual Data Tools; and 
OLE DB templates to simplify programming with OLE DB. 
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This section provides an overview of the following Visual C++ data access features. 
e ADO support (new) 


e Microsoft Visual Database Tools integration (new; includes Query Designer but not 
Database Designer) 


e OLE DB templates (new) 
e MFC database classes 


ADO 2.0 Support 


The new release of ADO features a simpler object model, better integration with Microsoft 
and non-Microsoft technologies, a common interface for both local and remote data access, 
remotable and disconnected recordsets, a user-accessible data binding interface, and 
hierarchical recordsets. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Database Support 

e¢ Microsoft Data-Bound Controls and Visual C++ 6.0 

e Getting Started with ADO 2.0 


Visual Database Tools Integration 


The Microsoft Visual Database Tools (Database Designer and Query Designer) provide a 
visual interface to help you create and modify database structures (schemas) and queries. 
You can create SQL Server and Oracle database tables, use drag-and-drop operations to 
create views, and automatically change column data types. 


Visual C++, Professional Edition includes the Query Designer. With Visual C++, 
Professional Edition, you can create and edit queries, and execute stored procedures. 


For More Information See Introducing Microsoft Visual Database Tools, online in MSDN 
Library Visual Studio 6.0. 


OLE DB Templates 


OLE DB templates make the high-performance OLE DB data access technology much 
easier to use by providing classes that implement many of the commonly used OLE DB 
interfaces. The OLE DB templates are provided in the form of a template library, similar to 
ATL. In addition, wizard support is available to generate code for common scenarios. 


The classes in the OLE DB template library can be divided into two groups: the consumer 
classes, which you use to implement a database client (consumer) application, and the 
provider classes, which you use to implement a database server (provider) application. 
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For More Information See the following topics online in MSDN Library Visual Studio 6.0. 
e Using the OLE DB Consumer Templates 
e Using the OLE DB Provider Templates 


MFC Database Classes 


The MFC database classes help you store information in a database. MFC contains two 
sets of database classes — DAO and ODBC — which provide similar functionality. The 
DAO classes are implemented using Data Access Objects; the ODBC classes are 
implemented using Open Database Connectivity. 


In general, use the MFC DAO classes when you want to work with databases that use the 
Microsoft Jet database engine, such as Microsoft Access databases (.mdb files). (You can 
also use DAO to work with external databases, such as ODBC data sources.) Use the MFC 
ODBC classes when you are not using Jet and you want to work with the ODBC API for 
complete data-source independence. 


For More Information See Database Topics (General), online in MSDN Library Visual 
Studio 6.0. 


Building Data-Centric Applications with Visual 
FoxPro 


You can use Visual FoxPro to create client/server applications that combine the 
functionality of Visual FoxPro on your local computer with the storage and security 
benefits provided by a remote server. You can build your application locally, and then use 
one of the Upsizing Wizards to transform the application for the client/server environment. 


A Visual FoxPro client/server application combines the power, speed, graphical user 
interface, and sophisticated querying, reporting, and processing of Visual FoxPro with the 
seamless multiuser access, massive data storage, built-in security, robust transaction 
processing, and native server syntax of an ODBC data source or server. This means you 
can have the benefits of a Microsoft SQL Server or Oracle database without t having to 
become a SQL Server or Oracle expert. 


Visual FoxPro provides two upsizing wizards: the SQL Server Upsizing Wizard and the 
Oracle Upsizing Wizard. Both of these wizards create databases that duplicate, as much as 
possible, the functionality of a set of tables in a Visual FoxPro database. You can also 
choose to redirect Visual FoxPro views so that they use the newly created remote data 
instead of local data. You can use the upsizing wizards to: 


e Move local data to a remote server. 
e Transform local base tables and local views into remote base tables and remote views. 


¢ Migrate a local application to a client/server application. 
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For More Information See Upsizing Visual FoxPro Databases, online in MSDN Library 
Visual Studio 6.0. 


Building Data-Centric Applications with Visual 
InterDev 


Visual InterDev provides you with great flexibility in designing data-centric Web 
applications. You can use any database supported by ActiveX Data Objects (ADO) for 
which you have drivers, including Microsoft SQL Server, Microsoft Access, Visual 
FoxPro, Oracle, and others. You can interact directly with the database or use views, stored 
procedures, and other database entities to manage the database. The database can be 
physically located on the same computer as your Web server or on a different computer. 
You can use the Web server for all your database access or access the database directly 
from a client computer. 


To make it easy to build data-centric applications, Visual InterDev provides the following 
features. 


e Database projects 

e Data View window 

e Visual Database Tools 
e Data environment 

e Data-bound controls 


e Source control for database objects 


Database Projects 


Database projects are a separate project type that you can add to your Visual InterDev 
solutions. They include the tools necessary to build and manage databases as a separate 
component from Web pages. 


For More Information See Managing Database Projects, online in MSDN Library Visual 
Studio 6.0. 


Data View Window 


The Data View window provides a live view of the data to which your database or Web 
project is currently connected. From the Data View window, you can launch tools to 
manage your database. 


For More Information See Data View Window, online in MSDN Library Visual Studio 6.0. 
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Visual Database Tools 


The Visual Database Tools are a set of tools (Database Designer and Query Designer) for 
managing and querying your database graphically. With the Database Designer, you can 
create and modify table definitions, column definitions, and relationships between tables in 
Microsoft SQL Server and Oracle databases. With the Query Designer, you can visually 
create and run SQL statements. A View Designer helps you create views. 


For More Information See Introducing the Visual Database Tools, online in MSDN Library 
Visual Studio 6.0. 


Data Environment 


The data environment is a repository in your Web project for information required to 
connect to and access data in databases. The data environment stores reusable connection 
strings that you can use to access databases from your Web pages. In addition, the data 
environment stores data commands that represent record sets, based on database objects or 
SQL commands. 


For More Information See The Data Environment, online in MSDN Library Visual Studio 
6.0. 


Data-Bound Controls 


The data-bound controls are controls such as text boxes, buttons, and so on that you can 
put on a Web page and that are automatically bound to specific fields in a database record. 
Data-bound controls already include the script required to make data connections, extract 
data, and update the database, so that you can build database access into your Web pages 
with little or no additional scripting. 


For More Information See the following topics online in MSDN Library Visual Studio 6.0. 


e Design-Time Controls 


source Control for Database Objects 


Source control for database objects provides a link between databases and your source 
control system so you can place SQL scripts and compiled stored procedures under source 
control. Source control makes development simpler and more secure if you have more than 
one database programmer working on a project. 


For More Information See Adding Source Control to a Database Project, online in MSDN 
Library Visual Studio 6.0. 
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Building Data-Centric Applications with Visual J++ 


Visual J++ provides design tools and wizards to make it easy for you to access data. You 
can add the Windows Foundation Classes for Java (WFC) data controls to your form in the 
Designer and quickly configure how data is retrieved and displayed. You can run the Data 
Form Wizard to automatically generate a data-bound form. 


For More Information See Accessing Data, online in MSDN Library Visual Studio 6.0. 


To make it easy to build data-centric applications, Visual J++ provides the following 
features, which are also part of Visual InterDev. 


e Database projects 
e Data View window 


e Visual Database Tools integration 


Database Projects 


Database projects are a separate project type that you can add to your Visual J++ solutions. 
They include the tools necessary to build and manage databases as a separate component 
from your Java applications. 


For More Information See Managing Database Projects, online in MSDN Library Visual 
Studio 6.0. 


Data View Window 


The Data View window provides a live view of the data to which your database project is 
currently connected. From the Data View window, you can launch tools to manage your 
database. 


For More Information See Data View Window, online in MSDN Library Visual Studio 6.0. 


Visual Database Tools 


The Visual Database Tools are a set of tools (Database Designer and Query Designer) for 
managing and querying your database graphically. With the Database Designer, you can 
create and modify table definitions, column definitions, and the relationships between 
tables in Microsoft SQL Server and Oracle databases. With the Query Designer, you can 
visually create and run SQL statements. A View Designer helps you create views. 


For More Information See Introducing the Visual Database Tools, online in MSDN Library 
Visual Studio 6.0. 
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The Island Hopper News Sample 


This chapter introduces the Microsoft® Visual Studio™ 6.0 sample application, Island 
Hopper News. Island Hopper News is a fictitious online newspaper, designed to be 
published on the World Wide Web. It features local, national, and international news; local 


sports; and local classified ads. 


The sample illustrates how you can design and structure applications using the Microsoft 
platform and the Visual Studio suite. The sample illustrates a piece of the full-blown Island 
Hopper News application: the classified ad section. Not all the functionality you might 
want or expect is present. The sample was implemented from parts intended to provide the 
best example for you — the parts from which you can extrapolate to build an application 
that suits your own needs and purposes. Throughout this chapter, "Island Hopper News" is 
used to refer to the classified ads section only, unless explicitly noted otherwise. 


The sample is available in two different versions, called "levels." Level A is a small-scale 
version of the application, suitable for a company intranet. Level C is an enterprise-scale 
version of the application, suitable for the Internet. Both levels include client applications, 
business and data access components, and databases. 


The topics in the following table contain information about the Island Hopper News 


Classified Ads sample. 
Section 


Overview of Island Hopper 
News 


Finding and Running Level A 


Level A Walk-Through — 
Windows 


Level A Walk-Through — 
Web 


Level A Specification 


Description 


Introduces the sample and both of its levels. 


Provides information on where to find the source code after you install the 
sample, and how to start both client applications for Level A. 


Describes the Windows client application for Level A from both a user's 
and a developer's perspective. 


Describes the Web client application for Level A from both a user's and a 
developer's perspective. 


Contains a specification for Level A of the Island Hopper News sample. 
Describes the database schema, business components, data access 
components, and client applications, both for the Windows and Web 
versions. 
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Section Description 


Finding and Running Level C —_— Provides information on where to find the source code after you install the 
sample, and how to start both client applications for Level C. 


Level C Walk-Through — Describes the Windows client application for Level C from both a user's 
Windows and a developer's perspective. 


Level C Walk-Through — Web Describes the Web client application for Level C from both a user's and a 
developer's perspective. 


Level C Specification Contains a specification for Level C of the Island Hopper News sample. 
Describes the database schema, business components, data access 
components, and those portions of the client applications that are added for 


Level C. 
Finding Out More About Island Provides a list of links to more information about the sample and its 
Hopper News underlying technologies. 


Overview of Island Hopper News 


The Island Hopper News application includes one section that is developed as a sample, 
the classified ads section. Other sections of the newspaper, such as news and sports, 
provide context. Two different versions of the classified ads application are included with 
Visual Studio, Level A and Level C. These levels are described later in this section. You 
can install either of the levels and work with them to understand the pieces of each 
application, how they fit together, and how they were put together. For installation 
prerequisites and instructions, see the Visual Studio Samples Page in MSDN Library 
Visual Studio 6.0. 


Level A 


Level A is a simple implementation that includes both a Windows and a Web client 
application. The two clients have identical functionality. Level A demonstrates both 
browsing and placing ads into a database. This level would be suitable for a small 
company intranet, because it does not support multiple users accessing the database at 
once. You can look at the two clients of Level A as reflecting a migration from a standard, 
Windows-style user interface to a Web interface. 
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The tools and technologies demonstrated in Level A include: 

e Microsoft® Visual Basic® and Microsoft® Visual InterDev™. 

e Active Server Pages (.asp). 

e Microsoft® Transaction Server (MTS). 

e Access toa Microsoft® Jet database using ActiveX® Data Objects (ADO). 
e Modularity and reusability with Component Object Model (COM) objects. 


e Client/server design, with separation of the user interface, the business processing, and 
the database services. 


For more information on Level A, refer to the following topics from this chapter. 
e Finding and Running Level A 

e Level A Walk-Through — Windows 

e Level A Walk-Through — Web 


Level C 


Level C is a full-fledged implementation that includes two client applications: a Web- 
based client for browsing and placing ads and a Windows client for updating customer 
records, invoices, and payments. Level C, which expands Level A by adding support for 
billing and security, would be suitable for the Internet. 


The tools and technologies demonstrated in Level C include: 


© Microsoft® Visual Basic®, Microsoft® Visual C++®, and Microsoft® Visual 
InterDev™. 


e Active Server Pages (.asp). 

e Microsoft® Transaction Server (MTS). 

e Access to Microsoft® SQL Server™ database using ActiveX® Data Objects (ADO). 
e Modularity and reusability with Component Object Model (COM) objects. 


e Multitiered design, with separation of the user interface, business processing, and 
database services. 


For more information on Level C, refer to the following topics from this chapter. 
e Finding and Running Level C 

e Level C Walk-Through — Windows 

e Level C Walk-Through — Web 

e Level C Specification 
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Finding and Running Level A 


Both Levels A and C of the Island Hopper News sample application are included on the 
MSDN library CD. You can run Setup for either version at any time. 


The installation process for Level A installs all the source code onto your local drive, as 
well as working versions of both the Windows and Web clients. The source code is located 
in Program Files\[slandHopper\ScenarioA, if you accept the installation defaults. Each 
business and data access component has its own folder, as shown in the following table. 


Folder 
bus_AdA 


ClassifiedsEXE 


CompatibleDLLs 


db_AdA 


db_CategoryA 


DLLs 


errPlusA 

Globals 

Packages 
util_TakeANumber 


WebA 


Contents 


Source code for the bus_AdA component, which handles the browsing and 
placing of ads within the application. 


Source code for the Windows client application, as well as a master project that 
points to the individual projects for the business and data access components. 


Compiled versions of the components used in the application. These components 
are gathered together into one directory for purposes of binary version 
compatibility; they provide the reference point. 


Source code for the db_AdA component, which handles updates and queries to the 
Advertisements table in the database. 


Source code for the db_CategoryA component, which handles updates and queries 
to the Categories table in the database. 


Compiled versions of the components used in the application. These are the actual 
run-time DLLs. 


Note that all of the Visual Basic projects for the components in Level A have the 
Binary Compatibility option set in the project properties. The Binary 
Compatibility option ensures that when you recompile a component, its CLSID 
stays constant — fixed to be that of the DLL in the CompatibleDLLs folder. The 
DLLs in the CompatibleDLLs folder are simply slightly older versions of the 
DLLs generated when you build any of the components in Level A. 


Source code for the error-handling portions of the application. 
Global code for the application. 
MTS-enabled versions of the components in the application. 


Source code for the TakeANumber utility, which assigns unique IDs when 
necessary. 


Source code for the Web client application. 
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To start the Windows client 
1. Click Start. 
2. Point to Programs. 
3. Point to Island Hopper. 
4. Click Island Hopper A. 


For More Information See Level A Walk-Through — Windows in this chapter for a 
description of both user flow and processing flow of the Windows version of the sample. 


To start the Web client 
1. Start Microsoft® Internet Explorer 4.0 or higher. 


2. Point the browser at the islandhoppera directory in your local Web root. For example, 
http://MyMachine/islandhoppera. 


For More Information See Level A Walk-Through — Web in this chapter for a description 
of both user flow and processing flow of the Web version of the sample. 


Level A Walk-Through — Windows 


This section describes how the Windows client application of the Island Hopper News 
sample Level A works, including both what you see as a user and what happens behind the 
scenes. If possible, run the application as you read through this section, and look at the 
source code, which you'll find in Program Files\IslandHopper\ScenarioA\classifieds.vbg. 
For complete information on all the different parts of Level A, see Level A Specification in 
this chapter. 


First Impressions 


When you start the Windows client, you see what appears to be a single form with the 
caption "Island Hopper News." 


This is actually an MDI form, frmParentA, which calls a child, frmAccountingA, 
immediately. The child form contains the controls and background you see. 


The main screen of the sample offers you the following three choices. 

e Browse Ads, for browsing through the ads in the database. 

e Ad Maintenance, for editing ads already in the database and for placing new ads. 
e Exit. 


Notice how the labels change color when you move the pointer over them. This is done by 
detecting the mouse move and changing the color of the labels. Look at the code for 
frmAccountingA and locate the Form_MouseMove and lblOption_MouseMove methods. 
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Browsing Ads 


Click Browse Ads to display the Browse Ads form, frmDisplayAdsA. This form consists 
of two parts: the list of ad categories on the left and the list of ads on the right. Click a 
category to see the ads in that category, and then click the title of an ad to see the text of 
the ad. 


How It's Done 


The list of categories is a standard ListBox control that is populated through a method 
called FillAdsByCategory. You can see this method if you look at the code for 
frmDisplayAdsA. The FillAdsByCategory method instantiates the db_CategoryA 
component to access the database, Classifieds.mdb, and return a list of all the categories in 
the Categories table. 


The list of ads is displayed by a WebBrowser control. The WebBrowser control is 
available with Internet Explorer 4.0 and later, and with it you can display Web pages as 
part of a Visual Basic form. The WebBrowser control locates the Web server and displays 
an Active Server Pages file, AdsList.asp, which contains the ads that apply to the selected 
category. To see how this is done, look at the IstCategory_Click event code for 
frmDisplay AdsA. 


Retrieving Ads 


Click Ad Maintenance to display the Ad Maintenance form, frmAdA. You can use this 
form to retrieve an ad from the database. You must supply both an e-mail address and a 
phone number to retrieve ads. If you have not placed any new ads yourself yet, you can use 
someone @ microsoft.com for the e-mail address and 555-5555 for the phone number to 
retrieve some ads. You can click Place Ads to place an ad, but you must supply an e-mail 
address and phone number first. 


How It's Done 


The Ad Maintenance form instantiates the bus_AdA component when it loads. When you 
fill in an e-mail address or phone number and click Retrieve, the corresponding bus_AdA 
method (ListByMail or ListByPhoneNumber) is called. Both of these methods instantiate 
the db_AdA component to perform the actual retrieval. 


The retrieved ads are displayed in an MSFlexGrid control. Double-clicking on an ad 
displays the Ad Details form, frmAdDetailA. Clicking Place Ads also displays the Ad 
Details form. 
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Placing and Editing Ads 


You can update, delete, or place new ads with the Ad Details form, frmAdDetailA. These 
three modes are controlled by a set of option buttons in the upper left corner. The mode 
that is enabled when the form is displayed depends on how you got to the form. If you 
clicked Place Ads, the Ad Details form is displayed with the Place New Ad option 
selected. If you double-clicked an ad on the Ad Maintenance form, the Ad Details form is 
displayed with the Update option selected and the ad's information displayed. You can 
delete an ad by clicking the Delete option button. 


How It's Done 


When the Ad Details form is loaded, it instantiates the bus_AdA component, calls the 
FillCategory and FillDuration methods to populate the Category and Duration combo 
boxes, and clears all the text fields in preparation for input. Then the form is activated. The 
activation code determines which option button should be enabled. 


The FillDuration method uses the ComboBox control's AddItem method to populate the 
Duration combo box. The FillCategory method instantiates the db_CategoryA component 
to access the database and retrieve the categories, and then uses the AddItem method to 
populate the combo box. 


When the Ad Details form is activated, it calls the RetrieveAdByID method to retrieve the 
ad from the database. RetrieveAdByID uses the GetByID method of bus_AdA to retrieve 
the ad information and populate the fields. 


Level A Walk-Through — Web 


This section describes how the Web client application of the Island Hopper News sample 
Level A works, including both what you see as a user and what happens behind the scenes. 
If possible, run the application as you read through this section, and look at the source 
code, which you'll find in Program Files\IslandHopper\ScenarioA\WebA if you accepted 
the installation defaults. Remember that you must use Internet Explorer 4.0 or higher. For 
complete information on all the different parts of Level A, see Level A Specification in this 
chapter. 


First Impressions 


When you start the Web client, the first page you see is Headlines.asp. This is the front 
page of Island Hopper News, the fictitious online newspaper that the sample is built on. 
Notice how interesting the page is, visually: moving the pointer over a section block, such 
as Top Stories, turns the text yellow. Also, the photographs on the right rotate, as do their 
headlines. Headlines.asp uses JavaScript and DHTML to achieve the visual effects. Look 
at the source code for information on how it's done. 
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Although you can click any of the five section blocks, the only one that displays a different 
page is Classified Ads. Clicking the other section blocks simply redisplays Headlines.asp. 
Click Classified Ads to display Browse.asp, the Browse/Place an Ad page. 


Browse.asp offers you the following two choices. 
e Browse An Ad 
e Place An Ad 


Notice how the labels change color when you move the pointer over them. Other items of 
interest on this page include another series of rotating images on the right and the 
navigation bar at the bottom. Like Headlines.asp, Browse.asp uses JavaScript and DHTML 
to produce these effects; look at the source code for Browse.asp to see how it's done. If 
you're interested in the navigation bar, look at NavigationBar.js. 


Browsing Ads 


Click Browse An Ad to display the Online Classified Advertisement Display page, 
AdDisplay.asp. This page consists of two parts: the list of categories on the left and the list 
of ads on the right. Click a category to see the ads in that category, and then click the title 
of an ad to see the text of the ad. AdDisplay.asp also contains a button called Place an Ad. 
That button displays AdEntry.asp, the form where you can place a new ad. 


How It's Done 


The list of categories is populated by a server-side script called DisplayCategories. You 
can see this script if you look at the code for AdDisplay.asp. The DisplayCategories script 
instantiates the db_CategoryA component to access the database, Classifieds.mdb, and 
return a list of all the categories in the Categories table. 


The list of ads is an additional frame populated by AdsList.asp. AdsList.asp is passed the 
ID of the selected category; it then displays the ads that apply to that category. To see how 
this is done, look at the code for AdDisplay.asp. 


Placing Ads 


You can place new ads with the Online Classified Advertisement Entry page, AdEntry.asp. 
This page presents a form that you fill out to specify your ad, the category it belongs in, 
how long you want it to run, and your e-mail address and phone number. When you are 
satisfied with the ad information, click Preview to see how your ad will look when it is 
displayed online. You can change the ad if you want, and then click Submit to place the ad 
in the database. 


The ad preview function is part of AdEntry.asp; clicking Preview does not request another 
page from the server. This ensures quick performance for users. The ad submit function 
does request another page (AdConfirm.asp) from the server, but only after the data has 
been validated. 
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Level A Specification 


Level A of the Island Hopper News sample consists of a database to store the classified 
ads, several COM components that encapsulate business and data access processing, a 
Windows client implemented in Visual Basic, and a Web client. 


The following table lists information contained in this section. 


Section Description 

Level A — Database Schema Describes the Jet database used to store the classified ads. 

Level A — Business and Data Describes the COM components that handle the business and data 
Access Components access processing. 


Level A — Windows User Interface Describes the details of the Windows client. 
Details 


Level A — Web User Interface Describes the details of the Web client. 
Details 


Level A — Database Schema 


The database used in Level A of the Island Hopper News sample is a Jet database called 
Classifieds.mdb. When you install Level A, the database is set up for you. It consists of the 
three tables described in the following table. 


Table name Description 

Advertisements Stores classified ads, along with information about the person who created the 
ad. 

Categories Stores categories, such as Baby Items or Housing to Rent, for classified ads. 

TakeANumber Assigns unique ID numbers for ads, categories, and customers. 


The fields and data types are described in the following tables. 
Fields in the Advertisements Table 


Field name Data type Description 

“AdvertisementID ~«“'Number —_—- Unique identifier for a particular classified ad. Primary key. _ 
Body Memo Text of the ad. 
CategoryID Number Identifier for the category to which this ad belongs. 
CreatedDate Date/Time Date the ad was created. 
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Fields in the Advertisements Table (continued) 


Field name Data type 
CustomerID Text 
Email Text 
EndDate Date/Time 
ModifiedDate Date/Time 
PhoneNumber Text 
StartDate Date/Time 
Title Text 


Fields in the Categories Table 


Field name Data type 
CategoryID Number 
CreatedDate Date/Time 
ModifiedDate Date/Time 
Name Text 


Fields in the TakeANumber Table 


Field name Data type 
NextNumber Number 
PropertyGroupName Text 


Description 


Unique identifier for a customer; one who places or browses 
ads. 


Customer's e-mail address. 

Date the ad ends. 

Date the ad was changed. 
Customer's daytime phone number. 
Date the ad begins. 

Title of the classified ad. 


Description 

Unique identifier for a category. Primary key. 
Date a category was created. 

Date a category was changed. 


Name of the category. 


Description 
Next unique number for that group of items. 


Identifies the group of items for which a unique identifier is 
needed. 


Level A — Business and Data Access Components 


The business and data access components used in Level A of the Island Hopper News 
sample are COM components that encapsulate processing. Using components in this way 
helps create a modular application, one that you can adapt as needed. It is much easier to 
replace one or two components than to rewrite and recompile an entire application, even a 
simple one like the one in Level A of the sample. 
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Why Two Levels? 


You might wonder why the Island Hopper sample separates the business components from 
the data access components. Why the level of abstraction? Here's why: Separating the data 
access components makes it possible to use specialized querying rules that are not strictly 
business rules and that are not appropriate for building into the storage engines, 
particularly when data is decentralized, as is typical in many companies. For instance, one 
query may want all customers, but "James Smith" at a specific address and "Jim Smith" at 
the same address should be recognized as the same person. This is perhaps a contrived 
example, but the point is that the data access code often becomes extremely complex and 
yet really does not belong with the business logic nor stored with the storage engine. 


A Note About Version Compatibility 


All of the Visual Basic projects for the business and data access components in Level A 
have the Binary Compatibility option set. The Binary Compatibility option ensures, among 
other things, that when you recompile a component, its CLSID will remain constant. 
Binary version compatibility makes it possible for you to enhance the components while 
ensuring that applications compiled using previous versions will still work with the new 
versions of the components. 


For More Information The Visual Basic documentation includes extensive information 
about version compatibility. See Version Compatibility in ActiveX Components online in 
MSDN Library Visual Studio 6.0 for information about the Visual Basic Version 
Compatibility feature, including a list of links to additional topics. 


Why Use Microsoft Transaction Server? 


The components for Level A all use Microsoft Transaction Server (MTS) for context. In 
MTS, context is a state that is implicitly associated with a given Microsoft Transaction 
Server object. Context contains information about the object's execution environment, such 
as the identity of the object's creator and, optionally, the transaction encompassing the 
work of the object. An object's context is similar in concept to the process context that an 
operating system maintains for an executing program. The Microsoft Transaction Server 
run-time environment manages a context for each object. 


Context simplifies the development of components, because each object independently 
acquires its own resources, performs its work, and indicates its own internal state by 
calling the MTS methods SetComplete or SetAbort before returning. 
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Component Summary — Level A 


Level A contains components described in the following tables. These are all written in 


Visual Basic. 

Level A Business Component 
Name 

bus_AdA 


Description 


Manages classified ads. Creates instances of db_AdA and 


(bus_AdA.cls, in the Ad class module | db_CategoryA where necessary to carry out database functions. 


in the bus_AdA project) 


Level A Data Access Components 


Name 
db_AdA 


Description 


Sends data to and retrieves data from the Advertisements table of 


(db_AdA.cls, in the Ad class module the Classified Ads database. Uses ADO for communication with 


in the db_AdA project) 
db_CategoryA 


the database. 


Sends data to and retrieves data from the Categories table of the 


(db_CategoryA.cls, in the Category Classified Ads database. Uses ADO for communication with the 
class module in the db_CategoryA database. 


project) 


Bus_AdA Methods 


Bus_AdA consists of the methods described in the following table. 


Method name 


Delete 


GetByID 


ListByCategory 


ListByEmail 


ListByPhoneNumber 
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Description 


Creates an instance of db_AdA and calls db_AdA's Delete method, passing 
it the unique ad ID. 


Creates an instance of db_AdA and calls db_AdA's GetByID method, 
passing it the unique ad ID. Also returns the requested ad information in a 
recordset. 


Creates an instance of db_AdA and calls db_AdA's ListByCategory method, 
passing it the unique category ID. Also returns the requested ad information 
in a recordset. 


Creates an instance of db_AdA and calls db_AdA's ListByEmail method, 
passing it the customer's e-mail address. Also returns the requested ad 
information in a recordset. 


Creates an instance of db_AdA and calls db_AdA's ListByPhoneNumber 
method, passing it the customer's phone number. Also returns the requested 
ad information in a recordset. 
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Method name Description 


PlaceAd Creates an instance of db_AdA and calls db_AdA's Add method, passing it 
all the ad information. Also creates an instance of TakeANumber and calls 
TakeANumber's GetANumber method to get a unique ID for the ad. Returns 
the unique ad ID after the ad is created in the database. 


UpdateAd Creates an instance of db_AdA and calls db_AdA's Update method, passing 
it the updated ad information. 


DB_AdA Methods 
DB_AdA consists of the methods described in the following table. 


Method name Description 

Add Adds a new classified ad to the database. 

Delete Deletes a classified ad from the database. 
GetAdCountByCategory Returns a count of all ads with a particular category ID. 
GetByID Retrieves an ad with a particular ID. 

ListByCategory Retrieves all ads for a particular category. 

ListByEmail Retrieves all ads for a particular customer e-mail address. 
ListByPhoneNumber Retrieves all ads for a particular customer phone number. 
Update Updates a classified ad in the database. 


DB_CategoryA Methods 
DB_CategoryA consists of the methods described in the following table. 


Method name Description 

Add Adds a new category to the database. 

Delete Deletes a category from the database. 

ListAll Retrieves an alphabetical list of all categories in the database. 

GetByID Retrieves a category with the specified ID. 

GetByName Retrieves a category with the specified name. 

GetBySearchString Retrieves all categories where the name contains the specified search string. 
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Method name Description 
ListByRange Retrieves all categories with IDs within a specified range. 
Update Updates a category in the database. 


Component Relationships and Flow 


Generally, the Visual Basic forms or .asp pages create an instance of the business object, 
bus_AdA. bus_AdA in turn creates an instance of the data access object it needs (db_AdA 
or db_CategoryA) to complete a task. 


Level A — Windows Client Details 


The Windows client for Island Hopper News Level A is implemented as a multiple- 
document interface (MDI) application. An MDI application contains one parent form and 
several child forms, which are displayed in the container provided by the parent form. 


The following picture shows how the forms in the Windows client are related. 


frmParenta 














frrnAccountingA 
(MDIChild= True) 










Click Browse Ads Click Ad Maintenance 















frmAdA 


frmDisplayAdaA 
(MDIChild=True) 


(MDIChild= True) 





frmAdDeatailA 
(MDIChild= True) 





62 Developing for Windows and the Web 


Form Reference 


Chapter 3 The Island Hopper News Sample 


The following table lists the forms in the Windows client by name and purpose. 


Form name 
frmAccountingA.frm 


frmAdA.frm 


frmAdDetailA.frm 


frmDisplayAdsA.frm 


frmParentA.frm 


Purpose 


Child of frmParentA. Presents the main screen of the Island Hopper News 
application. Has two child forms, frmDisplayAdA and frmAdA. 


Child of frmAccountingA. Displayed when you click Ad Maintenance on the 
Island Hopper News form. From here, you can retrieve ads from the database by 
e-mail address or phone number, as well as enter the Place Ads function. 


FrmAdA retrieves classified ads from the database by customer e-mail address or 
customer phone number. All ads that match the specified e-mail address or 
phone number are then displayed in an MSFlexGrid control on the bottom of the 
form. You can double-click a particular ad to edit its fields, or click the Place 
Ads button to place a new classified ad. Each of these actions displays the 
Advertisement Details dialog box, frmAdDetailA. 


The Advertisement Details dialog box. Displayed when you double-click one of 
the ads listed on the bottom of the Ad Maintenance screen or when you click 
Place Ads. From here, you can update an ad, delete an ad, or place a new ad. 


The form frmAdDetailA is a modal dialog box. You can update, delete, or place 
new ads using this dialog box. You can also move to the previous or next ad in 
the database. 


Child of frmAccountingA. Displayed when you click Browse Ads on the Island 
Hopper News form. From here, you can select a category in which to browse ads 
as well as browse the ads themselves. 


FrmDisplayAdA displays the ad categories and a list of the ads for each 
category. This form does not call any other forms, but it does use a WebBrowser 
control (available with Internet Explorer 4.0) to display the classified ads in the 
form of an .asp file, AdsList.asp. See Level A — Web Client Details in this 
chapter for more information about AdsList.asp. 


MDI parent form. Provides the Island Hopper News title bar. Has one child 
form, frmAccountingA. an 
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Form Flow 


The following picture shows the flow of the forms in the Windows client. 


1 
frmP arenta frmAccountingA 
2 


frmAccountingA 


frmDisplayAdA frmAdA 
3 
frmAdAaA frmAdDetailA 


1. When you start the Windows client from the Windows Start menu, the application 
loads frmParentA, which immediately loads and shows frmAccountingA. 


2. Now you can choose whether to browse ads, edit ads, or exit the application. 
Processing for each of these choices is shown in the following table. 


If you choose... FrmAccountingA will... 

“Browse Ads Load and show frmDisplayAdA, and then fill the list of categories on the form. _ 
Ad Maintenance Load and show frmAdA. 
Exit Unload and hide all forms, and then exit. 


3. If you choose to edit ads or place a new ad, frmAdA displays the Ad Details form, 
frmAdDetailA. 


Level A — Web Client Details 


The Web client for Island Hopper News level A is implemented in a series of Active 
Server Pages (.asp) files. The following picture shows how the .asp files in the Web client 
are related. 
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Default. htm Headlines. asp 


AdDisplay. asp AdEntry.asp 
AdsList.asp AdConfirm. asp 















Shared files: 


strFile.vbs browserCheck.vbs N avigationBar.js 





File Reference 
The following table lists the main files in the Web client by name and purpose. 
File name Purpose 


pe ey ee re ee 
AdConfirm.asp Called by AdEntry.asp after you submit the ad form. This page checks the input 
on AdEntry.asp, updates user data, and inserts the ad into the database. 


AdDisplay.asp Displayed when you click Browse an Ad on the Browse/Place an Ad page. On 
this page, you can click to select an ad category. After you select an ad category, 
the page calls AdsList.asp to get the list of ads for the category from the database 
and display the titles of the ads. You can click on an ad title to display the ad. 
You can click Place an Ad if you want to place an ad; doing so displays 
AdEntry.asp. 


AdEntry.asp Displayed when you click Place an Ad on the Browse/Place an Ad page. On this 
page, you can provide information about your ad using a form. You can click 
Preview to see what your ad will look like, and click Clear to clear the fields in 
the form. Clicking Preview displays AdConfirm.asp. 


AdsList.asp Called by AdDisplay.asp after you select a category to populate the list of ads in 
that category. 
Browse.asp Displayed when you click Classified Ads on the Island Hopper Headlines page. 


From here, you can browse or place an ad. Clicking Browse an Ad displays 
AdDisplay.asp; clicking Place an Ad displays AdEntry.asp. 


browserCheck.vbs Called by each .asp file to check the Internet Explorer version. If the browser 
version is not Internet Explorer 4.0, calls getMSIE4.htm, which displays a 
message advising you to upgrade your browser. 


Code.asp Called by ViewSource.js to display the source code for a particular page. 
Code.asp in turn calls CodeBrws.asp. 
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File name Purpose 

CodeBrws.asp Called by Code.asp to format and display a page of source code. 

Default.htm Loads Headlines.asp. 

getMSIE4.htm Displayed if the browser version is not Internet Explorer 4.0. 

Headlines.asp Main screen of the Web client. Shows the front page of Island Hopper News. 


From here, you can click on Classified Ads to go to the Classified Ads 
application (Browse.asp); all other links redisplay this page. 


NavigationBar.js Displays the navigation bar at the bottom of all pages. 
strFile.vbs Contains all text strings for the Web version of the application. 
ViewSource.js Displays the View Source button on pages. 

File Flow 


The following picture shows the flow of the pages in the Web client. 


Default. htm Headlines. asp 


AdDisplay.asp le»| AdEntry.asp 


1. When you start the Web client, the Default.htm page loads and immediately calls 
Headlines.asp. 


~ 


From Headlines.asp, you go to Browse.asp if you click the Classified Ads link. All 
other links redisplay Headlines.asp. 
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3. Browse.asp is the main page for the Classified Ads application. This is where you 
choose whether to browse or place an ad. Processing for each of these choices is shown 





in the following table: 

If you choose... Browse.asp calls... 
Browse an Ad AdDisplay.asp 
Place an Ad AdEntry.asp 


AdDisplay.asp calls AdsList.asp after you select a category in the Categories list. 
AdEntry.asp calls AdConfirm.asp after you preview your ad and click Submit. 


Finding and Running Level C 


Both Level A and Level C of the Island Hopper News sample are included on the MSDN 
library CD. You can run Setup for either version at any time. 


The installation process for Level C installs all the source code onto your local drive, as 
well as working versions of both the Windows and Web clients. The source code is located 
in Program Files\IslandHopper\ScenarioC\Source, if you accept the installation defaults. 
The Source folder contains the three folders in the following list. 


e Server_Components 
e VBClient 
e Web 


Source code for the server components for Level C, most of which are written in Visual 
Basic, is in the Server_Components folder; source for the Windows client is in the 
VBClient folder. Source code for the Web client is in the Web folder. 


Within the Server_Components folder, each business and data access component has its 
own folder, as described in the following table. 


Folder Contents 
a 
bus_AdC Source code for the bus_AdC component, which handles the browsing and 
placing of ads within the application. 

bus_CustomerC Source code for the bus_CustomerC component, which handles the 
creation, deletion, and modification of customer records. 

bus_InvoiceC Source code for the bus_InvoiceC component, which handles invoices. 
Bus_InvoiceC is written using Visual C++. 

bus_PaymentC Source code for the bus_PaymentC component, which handles payments. 

CompatibleDLLs Compiled versions of the components used in the application. These 


components are gathered together into one directory for purposes of binary 
version compatibility. 
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Folder ’ 
db_AdC 


db_CategoryC 
db_CustomerC 
db_CustomerPasswordC 
db_InvoiceC 


db_PaymentC 


db_ProductC 


DLLs 


Globals 
Interfaces 


util_TakeANumber 


util_ WordCount 
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Contents 


Source code for the db_AdC component, which handles updates and 
queries to the Advertisements table in the database. 


Source code for the db_CategoryC component, which handles updates and 
queries to the Categories table in the database. 


Source code for the db_CustomerC component, which handles updates and 
queries to the Customers table in the database. 


Source code for the db_CustomerPasswordC component, which handles 
updates and queries to the CustomerPasswords table in the database. 


Source code for the db_InvoiceC component, which handles updates and 
queries to the Invoice table in the database. 


Source code for the db_PaymentC component, which handles updates and 
queries to the Payment table in the database. Db_PaymentC is written 
using Visual C++. 


Source code for the db_ProductC component, which handles updates and 
queries to the Products table in the database. 


Compiled versions of the components used in the application. 


Note that all of the Visual Basic projects for the components in Level C 
have the Binary Compatibility option set in the project's properties. The 
Binary Compatibility option ensures that when you recompile a 
component, its CLSID stays constant — fixed to be that of the DLL in the 
CompatibleDLLs folder. The DLLs in the CompatibleDLLs folder are 
simply slightly older versions of the DLLs generated when you build any 
of the components in Level C. 


Global code for the application. 
Source code for the COM interfaces used in the application. 


Source code for the TakeANumber utility, which assigns unique IDs when 
necessary. 


Source code for the WordCount utility, which calculates the price of an ad 
based on the number of words in the ad. WordCount is written using 
Visual C++. 
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To start the Windows client 
1. Start SQL Server, if necessary. 
2. Click Start. 
3. Point to Programs. 
4. Point to Island Hopper. 
5. Click Island Hopper C. 


For More Information See Level C Walk-Through — Windows in this chapter for a 
description of both user flow and processing flow of the Windows version of the sample. 


To start the Web client 
1. Start Microsoft® Internet Explorer 4.0 or higher. 


2. Point the browser at the islandhopperc directory in your local Web root. For example, 
http://MyMachine/islandhopperc. 


For More Information See Level C Walk-Through — Web in this chapter for a description 
of both user flow and processing flow of the Web version of the sample. 


Level C Walk-Through — Windows 


This section describes how the Windows client of the Island Hopper News sample Level C 
works, including both what you see as a user and what happens behind the scenes. If 
possible, run the application as you read through this section, and look at the source code, 
which you'll find in Program 
Files\IslandHopper\ScenarioC\Source\VBClient\classifieds.vbg if you accepted the 
installation defaults. The source code for the server components is in Program 
Files\IslandHopper\ScenarioC\Source\Server_Components\Server_Components.vbg. For 
complete information on all the different parts of Level C, see Level C Specification in this 
chapter. 


First Impressions 


When you start the Windows client from the Start menu, you see what appears to be a 
single form with the caption "Island Hopper News." 


This is actually an multiple-document interface (MDI) form, frmParentC, which calls a 
child, frmAccountingC, immediately. The child form contains the controls and background 
you see. 
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The main screen of the sample offers you the following six choices. 
e Customer Maintenance 

e Account Activity 

e Payments 

e Ad Maintenance 

e Browse Ads 

e Exit 


You can see how Level C of the sample expands upon Level A by including the concepts 
of customers and billing and the functions that go along with those concepts. Now that 
paying customers use the application, you need a way to maintain their records and match 
customers with payments. You also need a way to track what a customer owes for placing 
ads (invoices) and what a customer pays (payments). 


For More Information See Level A Walk-Through — Windows in this chapter for 
information on how the Windows version of Level A works. 


The Ad Maintenance form changes slightly from Level A. Now you can retrieve ads by 
customer ID and customer e-mail. You can also search by customer last name. 


Notice how the labels change color when you move the pointer over them. This is done by 
detecting the mouse move and changing the color of the labels. Look at the code for 
frmAccountingC and locate the Form_MouseMove and IblOption_MouseMove functions. 


Maintaining Customer Records 


Click Customer Maintenance to display the Customer Maintenance form, frmCustomerC, 
This form presents three options: you can add a new customer record to the database, 
update customer records, or delete a customer record from the database. You can use the 
customer in the following table to try out the search functions. 


ID Name E-mail . 
11901 Masters, Steven someone @ microsoft.com 
How It's Done 


All of these tasks are carried out by the bus_CustomerC component, which contains the 
business logic and subsequently creates data access objects, such as db_CustomerC, to 
perform the actual work with the database. 
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Inquiring About Invoices 


Click Invoice Inquiry to display the Invoice Inquiry form, frmInvoiceC. With this form, 
you can retrieve invoices from the database by the invoice ID, the customer ID, or the 
customer e-mail address. You can also search for an invoice by customer last name. 
Invoices that match your search criteria are listed in a grid control at the bottom of the 
form. You can double-click any listed invoice to see detailed information about that 
invoice on the Invoice Details form, frmInvoiceDetailsC. 


You can use the customer in the following table to try out the search functions. 
ID Name E-mail 


11901 Masters, Steven someone @ microsoft.com 


How It's Done 


frmInvoiceC instantiates the bus_CustomerC component to retrieve the invoices from the 
database. The bus_CustomerC component in turn creates data access objects as needed. 


Tracking Payments 


Click Payments to display the Payments form, frmInputPaymentC. With this form, you can 
enter a payment for an invoice. You can retrieve customer information from the database 
using the customer ID or e-mail address. You can also search for a customer by last name. 


You can use the customer in the following table to try out the search functions. 
ID Name E-mail 


11901 Masters, Steven someone @ microsoft.com 


How It's Done 


The Payments form instantiates the bus_CustomerC component to handle retrieving 
customer information from the database. It also instantiates the bus_PaymentC component 
to handle adding payments to the database. 


Retrieving Ads 


Click Ad Maintenance to display the Ad Maintenance form, frmAdC. You can use this 
form to retrieve an ad from the database. You can search for a customer by last name 
without supplying any input. You can also retrieve ads by customer [D or customer e-mail 
address if you have that information. You can click Place Ads to place an ad, but you must 
supply a valid customer ID first. 
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You can use the customer in the following table to try out the search functions. 
ID Name E-mail 


11901 Masters, Steven someone @ microsoft.com 


The retrieved ads are displayed in an MSFlexGrid control. You can double-click on an ad 
to display the Ad Details form, frmAdDetailA. Clicking Place Ads also displays the Ad 
Details form. 


How It's Done 


This form, which is running on the client machine, instantiates the bus_CustomerC 
component on the server machine when it loads. When you fill in a customer ID or e-mail 
address and click Retrieve, the corresponding bus_CustomerC method (GetByID or 
GetByE-mail) is called. Both of these methods instantiate the db_CustomerC component to 
perform the actual retrieval. 


Browsing Ads 


Click Browse Ads to display the Browse Ads form, frmDisplayAdsC. This form consists 
of two parts: the list of categories on the left and the list of ads on the right. You click a 
category to see the ads in that category, and then click the title of an ad to see the text of 
the ad. 


How It's Done 


The list of categories is a standard ListBox control that is populated through a method 
called FillAdsByCategory. You can see this method if you look at the code for 
frmDisplayAdsC. The FillAdsByCategory method instantiates the db  CategoryC 
component to access the database and return a list of all the categories in the Categories 
table. 


The list of ads is a WebBrowser control. The WebBrowser control is available with 
Internet Explorer 4.0 and later, and with it you can run Web pages as part of a Visual Basic 
form. The WebBrowser control locates the Web server and displays an Active Server 
Pages file, AdsList.asp, which contains the ads that apply to the category you selected. To 
see how this is done, look at the IstCategory_Click function in the code for 
frmDisplayAdsC. 
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Placing and Editing Ads 


You can update, delete, or place new ads with the Ad Details form. These three modes are 
controlled by a set of option buttons in the upper left corner. The mode that is enabled 
when the form is displayed depends on how you got to the form. If you clicked Place Ads, 
the Ad Details form is displayed with the Place New Ad option selected. If you double- 
clicked an ad on the Ad Maintenance form, the Ad Details form is displayed with the 
Update option selected and the ad's information displayed. 


How It's Done 


When the Ad Details form is loaded, it instantiates the bus_AdC component, calls the 
FillCategory and FillDuration methods to populate the Category and Duration combo 
boxes, and clears all the text fields in preparation for your input. Then the form is 
activated. The activation code determines which option button should be enabled. 


The FillDuration method simply uses the AddItem method to populate the Duration combo 
box. The FillCategory method instantiates the db_CategoryC component to access the 
database and retrieve the categories, and then uses the AddItem method to populate the 
combo box. 


When the Ad Details form is activated, it calls the RetrieveAdByID subroutine to retrieve 
the ad from the database. RetrieveAdByID uses the GetByID method of bus_AdC to 
retrieve the ad information and populate the fields. 


Level C Walk-Through — Web 


This section describes how the Web client of the Island Hopper News sample Level C 
works, including both what you see as a user and what happens behind the scenes. If 
possible, run the application as you read through this section, and look at the source code, 
which you'll find in Program Files\IslandHopper\ScenarioC\Source\Web if you accepted 
installation defaults. For complete information on all the different parts of Level C, see 
Level C Specification in this chapter. 


First Impressions 


When you start the Web client (http://servermachine/islandhopperc), the first page you see 
is Headlines.asp. This is the front page of Island Hopper News, the fictitious online 
newspaper on which the sample is built. Notice how interesting the page is, visually: 
moving the pointer over a section block, such as Top Stories, turns the text green and italic, 
and the photographs on the right rotate, as do their headlines. Headlines.asp uses 
JavaScript and DHTML to achieve the visual effects. Look at the source code for 
information on how it's done. 
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Although you can click any of the five section blocks, the only one that displays a different 
page is Classified Ads. The other links are there to provide context; in the sample, clicking 
the other section blocks simply redisplays Headlines.asp. Clicking Classified Ads displays 

Browse.asp, the Browse/Place an Ad page. 


Browse.asp offers you the following two choices. 
e Browse An Ad 
e Place An Ad 


Although clicking Browse An Ad goes immediately to the Online Classified 
Advertisement Display page, you must log in with your e-mail address and password to 
place an ad. If you click Place An Ad without logging in, the text "To place an ad, you 
must first log in" changes to bold. If you do not have an account yet, click New User to 
create one. 


Notice how the labels change color and style when you move the pointer over them. Other 
items of interest on this page include another series of rotating images on the right and the 
navigation bar at the bottom. Like Headlines.asp, Browse.asp uses JavaScript and DHTML 
to produce these effects; look at the source code for Browse.asp to see how it's done. If 
you're interested in the navigation bar, look at NavigationBar.js. 


Browsing Ads 


Choosing Browse An Ad displays AdDisplay.asp, the Online Classified Advertisement 
Display page. This page consists of two parts: the list of categories on the left and the list 
of ads on the right. Click a category to see the ads in that category, and then click the title 
of an ad to see the text of the ad. 


How It's Done 


The list of categories is populated by a server-side script called DisplayCategories. You 
can see this script if you look at the code for AdDisplay.asp. The DisplayCategories script 
instantiates the db_CategoryC component to access the database and return a list of all the 
categories in the Categories table. 


The list of ads is an additional frame populated by AdsList.asp. AdsList.asp is passed the 
ID of the selected category; it then displays the ads that apply to that category. To see how 
this is done, look at the code for AdDisplay.asp. 


AdDisplay.asp also contains a button called Place an Ad. That button displays 
AdEntry.asp, the form where you can place a new ad. 
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Placing Ads 


You can place new ads with the Online Classified Advertisement Entry page, AdEntry.asp. 
This page presents a form that you fill out to specify your ad, the category it belongs in, 
how long you want it to run, and your e-mail address and phone number. When you are 
satisfied with the ad information, click Preview to see how your ad will look when it is 
displayed online. You can change the ad if you want, and then click Submit to place the ad 
in the database. 


The ad preview function is part of AdEntry.asp; clicking Preview does not request another 
page from the server. This ensures quick performance for users. The ad submit function 
does request another page from the server, AdConfirm.asp, but only after the data has been 
validated. 


Place an Ad includes a link to the Customer Maintenance form, CustMain.asp, where you 
can set up a new user account. 


Notice that the Web version of Level C does not include functions for customer 
maintenance, invoices, or payments. The assumption behind this design is that both the 
Windows version and the Web version could be used at the same time. Customers would 
use the Web version via the Internet to browse and place ads; employees at Island Hopper 
News would use the Windows version at the office to work with customer records, 
invoices, and payments. 


Level C Specification 


With Level C of the Island Hopper News sample, you can browse and place ads using a 
Web client to access the database where the classified ads are stored. You must establish a 
customer account with a login and password before you can browse or place ads. You can 
use a Windows client to maintain customer records, invoices, and payments. Level C adds 
the concepts of billing and security to become an application suitable for the Internet. 


Level C consists of a database to store the classified ads, several COM components that 
encapsulate business and data access processing, a Windows client, and a Web client. 


This following table lists information contained in this section. 
Section Description 
Level C — Database Schema Describes the SQL Server database used to store the classified ads. 


Level C — Business and Data Describes the COM components that handle the business and data access 


Access Components processing. 

Level C — Windows User Describes the details of the Windows client. 
Interface Details 

Level C — Web User Interface Describes the details of the Web client. 
Details 
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Level C — Database Schema 


The Island Hopper News sample Level C database is a SQL Server database called 
Classifieds.sql. When you run the database setup portion of the Level C setup, the database 
is created and filled with data for you. It consists of the tables described in the following 
list. 


Table name Description 

Advertisements Stores classified ads. 

Categories Stores categories for classified ads. 

CustomerPasswords Stores passwords for customers. 

Customers Stores customer information. 

InvoiceDetails Stores information about each ad on an invoice (a customer can have more 
than one classified ad on the same invoice). 

Invoices Stores information about an invoice. 

Payments Stores information about customer payments. 

Products Stores information about Island Hopper News company's products. Currently, 


there are only two: a classified ad with 100 or fewer words, and a classified ad 
with 100 to 200 words. As the Island Hopper News company expands, it 
could offer additional products, each of which would be stored in the Products 
table. 


TakeANumber Assigns unique ID numbers for ads, categories, and customers. 


Level A Tables Reused in Level C 


Level C reuses the Advertisements, Categories, and TakeANumber tables from Level A. 
For more information about these tables, see Level A — Database Schema in this chapter. 
Changes to the tables or their data types are summarized in the following descriptions. 


Advertisements Table 


The Advertisements table in Level C is almost the same as the Advertisements table in 
Level A, with the following differences: 


e The InvoiceID field is added to track the invoice to which the ad belongs. 


e The E-mail and PhoneNumber fields are not used (they move to the Customers table, 
where all customer information is tracked). 


e Number data types become integers; the Memo data type (used for the Title field) 
becomes a varchar data type. 
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Categories Table 


The Categories table in Level C is the same as the Categories table in Level A, except that 
Number data types become integers and the Text data type, used for the Name field, 
becomes a varchar data type. 


TakeANumber Table 


The TakeANumber table in Level C is the same as the TakeANumber table in Level A, 
except that the NextNumber field data type changes from Number to integer and the 
PropertyGroupName field data type changes from Text to varchar. 


Tables Added to the Level C Database 


The fields and data types of the tables added to the database for Level C are shown in the 
following tables. 


Fields in the CustomerPasswords Table 





Field name Data type Description 
CustomerID integer Unique customer identifier. 
Password varchar Customer password. 


Although it has a one-to-one relationship, the CustomerPasswords table is separate from 
the Customers table. This separation makes it possible for you to implement different 
security settings for each table. 


Fields in the Customers Table 


Field name Data type Description 

Address varchar Customer's street address. 
City varchar Customer's city. 

Country varchar Customer's country. 
CustomerID int Unique customer identifier. 
Email varchar Customer's e-mail address. 
FirstName varchar Customer's first name. 
LastName varchar Customer's last name. 
PhoneNumber varchar Customer's phone number. 
PostalCode varchar Customer's postal code. 
State varchar Customer's state. 
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Adding billing functionality to Level C makes it necessary to track information about each 
person who places an ad, so a Customers table was added to the database. 


Fields in the InvoiceDetails Table 


Field name 


Description 


DetailID 


InvoiceID 
Price 


ProductCode 


Quantity 


UnitOfMeasure 


Data type 
varchar 
int 

int 
decimal 
varchar 
int 


varchar 


Fields in the Invoices Table 


Field name 
CustomerID 


Description 


InvoiceDate 
InvoiceID 
InvoiceTotal 


Reference 


Data type 
int 


varchar 


datetime 
int 
decimal 


varchar 
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Description 


Text description of the item associated with this invoice entry. In 
the sample, this field contains the title of the ad associated with 
this invoice entry. 


Unique identifier for each item listed on the invoice. In the 
sample, this field contains a unique identifier for each ad. 


Unique identifier for each invoice (primary key). 
Price of product or service; in the sample, price of ad. 


Unique identifier for an entry in the Products table. In the sample, 
this field indicates word count, because 100-word ads are priced 
differently from 200-word ads. 


Answers the question, "how many?" In the sample, this field 
contains the number of words in the ad. 


Answers the question, "of what?" In the sample, this field 
contains the duration of ad. 


Description 
Unique identifier for a customer. 


Describes the product to which the invoice applies. In the 
sample, this field is always "Classified Ad Invoice." 


Date of the invoice. 
Unique identifier for the invoice. 
Total amount of invoice. 


Additional pertinent information. In the sample, this field 
contains the unique identifier of the ad, for reference. 
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Both Invoices and Invoice Details are general purpose invoice tables. In the sample, these 
tables are used as follows: when you place an ad, the sample generates an invoice and the 
line item on the invoice corresponds to the ad. For the purposes of the sample, each invoice 
only has one invoice detail that corresponds to one ad. However, in the context of a larger 
application (keeping in mind that the sample represents only one part of such an 
application), you can imagine an invoice with multiple line items (invoice details), each 
representing different goods or services from the Island Hopper company. Designing the 
invoice tables this way shows how a company can use one invoicing scheme throughout. 


Fields in the Payments Table 


Field name 
CardExpDate 
CardNumber 
CustomerID 


InvoiceID 


PaymentAmt 
PaymentDate 
PaymentID 


PaymentMethod 


Data type 
datetime 
varchar 
int 


int 


decimal 
datetime 
int 


varchar 


Fields in the Products Table 


Field name 


Description 


ProductCode 


UnitOfMeasure 


UnitPrice 


Data type 


varchar 


varchar 


varchar 


decimal 


Description 

Expiration date of credit card. 
Credit card number. 

Unique identifier for the customer. 


Unique identifier for the invoice to which this payment 
applies. 


Amount of payment. 
Date of payment. 
Unique identifier of this payment. 


Payment method. 


Description 


Description of the product. In the current implementation of 
Island Hopper News, the product is a classified ad, either 100 or 
200 words. 


Unique identifier for a product. 


The way a product is measured for invoicing. In the sample, this 
field contains the ad duration. 


Unit price for a product. In the sample, this field contains the ad 
price (100 and 200-word ads have different prices). 
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Level C — Business and Data Access Components 


The Island Hopper News sample Level C business and data access components are COM 
components that encapsulate processing. Using components in this way helps create a 
modular application, one that you can adapt as needed. It is much easier to replace one or 
two components than to rewrite an entire application. 


Why Two Levels? 


You might wonder why the Island Hopper News sample separates the business 
components from the data access components. Why the level of abstraction? Here's why: 
Separating the data access components makes it possible to use specialized querying rules 
that are not strictly business rules and that are not appropriate for building into the storage 
engines, particularly when data is decentralized, as is typical in many companies. For 
instance, one query may want all customers, but "James Smith" at a specific address and 
"Jim Smith" at the same address should be recognized as the same person. This is perhaps 
a contrived example, but the point is that data access code often becomes extremely 
complex and yet really does not belong with the business logic nor stored with the storage 
engine. 


Component Summary — Level C 


Level C contains the components described in the following table. Most of these are 
written in Visual Basic. 


Level C Business Components 
Name Description 


bus_AdC Manages classified ads. Creates instances of db_AdC, db_CategoryC, 
db_ProductC, where necessary to carry out database functions. Reused 
from Level A with added functionality. 


bus_CustomerC Manages customer information. 
bus_InvoiceC Manages invoices. Written using Visual C++. 
bus_PaymentC Manages customer payments. 
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Level C Data Access Components 
Name 
db_AdC 


db_CategoryC 
db_CustomerC 
db_CustomerPasswordC 
db_InvoiceC 
db_PaymentC 
db_ProductC 

util_ TakeANumber 


util WordCount 


Chapter 3. The Island Hopper News Sample 


Description 


Sends data to and retrieves data from the Advertisements table in the 
Classifieds database. 


Sends data to and retrieves data from the Categories table in the 
Classifieds database. 


Sends data to and retrieves data from the Customers table in the 
Classifieds database. 


Sends data to and retrieves data from the CustomerPasswords table in the 
Classifieds database. 


Sends data to and retrieves data from the Invoices and InvoiceDetails 
table in the Classifieds database. 


Sends data to and retrieves data from the Payments table in the 
Classifieds database. Written using Visual C++. 


Sends data to and retrieves data from the Products table in the Classifieds 
database. 


Utility component that assigns unique IDs to customers, invoices, and 
ads. 


Utility component that counts words in ads to calculate ad price. Written 
using Visual C++. 


Level C — Windows Client Details 


The user interface for the Windows version of Island Hopper News Level C is 
implemented as a multiple-document interface (MDI) application. An MDI application 
contains one parent form and several child forms, which are displayed in the container 


provided by the parent form. 
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The following picture shows how the forms in the Windows user interface are related. 


frmParentc 
(MDIChild=True) 


frmAccountingc 
(MDIChild=True) 


frmCustomerc frmInputPaymentc 
(MDIChild= True) (MDIChild=True) 


frmAdc frmAdDetailsc 
(MDIChild=True) (MDIChild=False 
frmAdDetailsc 
(MOIChild=False 


frmCustomerSearchc 
(MDIChild=True) 


frmInvoicec 
(MDIChild=True) 


frmiInvoiceDetailsc 
(MDIChild= False) 


Form Reference 
The following table lists the forms in the Windows user interface by name and purpose. 
Form name Purpose 


frmAccountingC.frm Child of frmParentC. Presents the main screen of the Island Hopper 
News application. Has five child forms, frmCustomerC, frmInvoiceC, 
frmInputPaymentC, frmAdC, and frmDisplayAdC. 


frmAdC.frm Child of frmAccountingC. Displayed when you click Ad Maintenance on 
the Island Hopper News form. From here, you can retrieve ads from the 
database by customer ID or customer e-mail address, search for a 
customer by last name, or enter the Place Ads function. 


frmAdC retrieves classified ads from the database by customer ID or 
customer e-mail address. All ads that match the specified ID or e-mail 
address are then displayed in an MSFlexGrid control on the bottom of the 
form. You can double-click a particular ad to edit its fields, or click the 
Place Ads button to place a new classified ad. Each of these actions 
displays the Advertisement Details dialog box, frmAdDetailC. 
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Form name 
frmAdDetailC.frm 


frmCustomerC.frm 


frmCustomerSearchC.frm 


frmDisplayAdsC.frm 


frmInputPaymentC.frm 


frmInvoiceC.frm 


frmInvoiceDetailsC.frm 


frmParentC.frm 
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Purpose 


The Advertisement Details dialog box. Displayed when you double-click 
one of the ads listed on the bottom of the Ad Maintenance screen or when 
you click Place Ads. From here, you can update an ad or place a new ad. 


The form frmAdDetailC is a modal dialog box. You can update ads or 
place new ads using this dialog box. You can also move to the previous 
or next ad in the database. 


Child of frmAccountingC. Displayed when you click Customer 
Maintenance on the Island Hopper News form. From here, you can add a 
new customer to the database, update a customer's record, or delete a 
customer from the database. 


Child of frmCustomerC. Displayed when you click Search by Last Name 
on the Customer Maintenance form. This is a dialog box where you can 
enter a customer's last name and request a search of the database for that 
last name. 


Child of frmAccountingC. Displayed when you click Browse Ads on the 
Island Hopper News form. From here, you can select a category in which 
to browse ads as well as browse the ads themselves. 


frmDisplayAdC displays the ad categories and a list of the ads for each 
category. This form does not call any other forms, but it does use a 
WebBrowser control (available with Internet Explorer 4.0) to display the 
classified ads in the form of an .asp file, AdsList.asp. See User Interface 
Details — Web Application (Level C) in this chapter for more 
information about AdsList.asp. 


Child of frmAccountingC. Displayed when you click Payments on the 
Island Hopper News form. This is a form where you can retrieve 
customer information from the database and enter payment information 
for a specific customer. 


Child of frmAccountingC. Displayed when you click Invoice Inquiry on 
the Island Hopper News form. This is a form where you can retrieve 
invoice or customer information from the database. You can get a list of 
the invoices for a particular customer, and then double-click on a 
particular invoice to display the Invoice Details form. 


Invoice Details dialog box. Displayed when you double-click an invoice 
listed on the Invoice form. This form shows information about a 
particular invoice. 


MDI parent form. Provides the Island Hopper News title bar. Has one 
child form, frmAccountingC. 
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Form Flow 


1. 


When you start the Windows version of Island Hopper News from the Windows Start 
menu, the application loads frmParentC, which immediately loads and shows 
frmAccountingC. 


Now you can choose whether to work with customer records, invoices, or payments; 
browse ads; edit ads; or exit the application. Processing for each of these choices is 
described in the following table. 


If you choose... frmAccountingC will... 

Ad Maintenance Load and show frmAdC. 

Browse Ads Load and show frmDisplayAdcC, and then fill the list of categories on the form. 
Customer Maintenance Load and show frmCustomerC. 

Exit Unload and hide all forms, and then exit. 

Invoice Inquiry Load and show frmInvoiceC. 

Payments Load and show frmInputPaymentC. 


. If you choose to search for a customer by last name, frmCustomerC calls the Search for 


Customer By Name dialog box (frmCustomerSearchC). Note that other forms that 
permit searching by customer last name, including the Invoice form and the Payment 
form, can also call the Search for Customer By Name dialog box. 


If you choose to work with a particular invoice, frmInvoiceC calls the Invoice Details 
form (frmInvoiceDetailsC) after you retrieve invoice information from the database. 


If you choose to edit ads or place a new ad, frmAdC displays the Ad Details form, 
frmAdDetailC. 


Level C — Web Client Details 


The Web user interface for the Island Hopper News sample Level C is implemented in a 
series of Active Server Pages (.asp) files. 


File Reference 


The following table lists the main files in the Web user interface by name and purpose. 
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File name 


AdConfirm.asp 


AdDisplay.asp 


AdEntry.asp 


AdsList.asp 


Browse.asp 


browserCheck.vbs 


Code.asp 


CodeBrws.asp 
CustMaint.asp 
Default.htm 

getMSIE4.htm 


Headlines.asp 


Login.asp 


NavigationBar.js 


strFile.vbs 


ViewSource.js 
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Purpose 


Called by AdEntry.asp after you submit the ad form. This page checks the input 
on AdEntry.asp, updates user data, and inserts the ad into the database. 


Displayed when you click Browse an Ad on the Browse/Place an Ad page. On 
this page, you can click to select an ad category. After you select an ad category, 
the page calls AdsList.asp to get the list of ads for the category from the database 
and display the titles of the ads. You can click on an ad title to display the ad. 
You can click Place an Ad if you want to place an ad; doing so displays 
AdEntry.asp. 


Displayed when you click Place an Ad on the Browse/Place an Ad page. On this 
page, you can provide information about your ad using a form. You can click 
Preview to see what your ad will look like, and click Clear to clear the fields in 
the form. Clicking Preview displays AdConfirm.asp. 


Called by AdDisplay.asp after you select a category to populate the list of ads in 
that category. 


Displayed when you click Classified Ads on the Island Hopper Headlines page. 
From here, you can browse or place an ad. Clicking Browse an Ad displays 
AdDisplay.asp; clicking Place an Ad displays AdEntry.asp. 


Called by each .asp file to check the Internet Explorer version. If the browser 
version is not Internet Explorer 4.0, calls getMSIE4.htm, which displays a 
message advising you to upgrade your browser. 


Called by ViewSource.js to display the source code for a particular page. 
Code.asp in turn calls CodeBrws.asp. 


Called by Code.asp to format and display a page of source code. 
Called by Browse.asp to create a new customer account. 

Loads Headlines.asp. 

Displayed if the browser version is not Internet Explorer 4.0. 


Main screen of the Web application. Shows the front page of Island Hopper 
News. From here, you can click on Classified Ads to go to the Classified Ads 
application (Browse.asp); all other links redisplay this page. 


Displays messages about logging in status, depending on where user came from. 
Displays the navigation bar at the bottom of all pages. 
Contains all text strings for the Web version of the application. 


Displays the View Source button on pages. 
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File Flow 


1. 


When you start the Web version of Island Hopper News, the Default.htm page loads 
and immediately calls Headlines.asp. 


From Headlines.asp, click the Classified Ads link to go Browse.asp. All other links 
redisplay Headlines.asp. 


Browse.asp is the main page for the Classified Ads application. This is where you 
choose whether to browse or place an ad. Processing for each of these choices is shown 
in the following table. 


If you choose... Browse.asp calls... 
Browse an Ad AdDisplay.asp 
New User CustMaint.asp 
Place an Ad AdEntry.asp 


You must log in with an e-mail address and password before you can browse or place 
ads. 


AdDisplay.asp calls AdsList.asp after you select a category in the Categories list. 
AdEntry.asp calls AdConfirm.asp after you preview your ad and click Submit. 


Finding Out More About Island Hopper News 


This chapter presents the bare bones of the Island Hopper News sample included with 
Visual Studio, describing its parts and how they fit together. More material is available on 
the Visual Studio Web site as www.microsoft.com/vstudio, including white papers that 
address in-depth scenarios, such as: 


Migrating an Application to the Web. 

From Intranet to Internet: Making the Change. 

Writing Setup for Island Hopper. 

Tips for Organizing an ASP or DHTML File. 

Middle Tier Components: Distinctions Between Data and Business Components. 


Structuring your Multi-tier Application: How to Organize Your Business Rules for 
Optimal Reusability. 


Design Tradeoffs When Building Your Database. 


User Interface Design Decisions. 
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